AI导哈

任务管理连接服务

Motion MCP Server是一个连接AI助手与Motion任务和项目管理平台的中间件服务，提供完整的API访问、智能速率限制和持久化状态管理。

  • by h3ro-dev
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 h3ro-dev/motion-mcp-server

使用说明

运动MCP服务器

将AI助手连接到 运动 用于任务和项目管理。

安装

npm install -g @h3ro-dev/motion-mcp-server

快速设置

1.获取运动API密钥

运动 → 设置→ API与集成→ 创建新的API密钥

2.配置

Claude Desktop 
{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["-y", "@h3ro-dev/motion-mcp-server"],
      "env": {
        "MOTION_API_KEY": "your-api-key"
      }
    }
  }
}

配置位置：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
  • Linux： ~/.config/Claude/claude_desktop_config.json
Cursor 
{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["-y", "@h3ro-dev/motion-mcp-server"],
      "env": {
        "MOTION_API_KEY": "your-api-key"
      }
    }
  }
}
VS Code (with Continue) 
{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["-y", "@h3ro-dev/motion-mcp-server"],
      "env": {
        "MOTION_API_KEY": "your-api-key"
      }
    }
  }
}

3.重新启动您的AI助手

特性

  • ✅ 所有运动API -任务、项目、工作区、用户、评论、重复任务、日程安排
  • 🚦 智能速率限制 -自动处理Motion的12个需求/3分钟限制
  • 💾 持久状态 -SQLite数据库在重启过程中保持速率限制
  • 🔍 清除错误 -调试有用信息
  • 📝 完整TypeScript -类型安全可靠

使用示例

"List my tasks"
"Create task: Review budget, due Friday, high priority"
"Move task abc123 to Marketing workspace"
"Add comment to task xyz789: Waiting for approval"
"Create recurring task: Daily standup at 9am"

工具参考

Task Management (7 tools)
工具 说明 示例
motion_list_tasks 使用筛选器列出任务 workspaceId, status, assigneeId
motion_get_task 获取任务详细信息 taskId
motion_create_task 创建新任务 name, workspaceId, dueDate, priority
motion_update_task 更新任务 taskId, status, priority
motion_delete_task 删除任务 taskId
motion_move_task 移动到工作区 taskId, workspaceId
motion_unassign_task 删除受让人 taskId
Project Management (5 tools)
工具 说明 示例
motion_list_projects 列出项目 workspaceId
motion_get_project 获取项目详细信息 projectId
motion_create_project 创建项目 name, workspaceId
motion_update_project 更新项目 projectId, name
motion_archive_project 归档项目 projectId
Other Tools (8 tools)
工具 说明
motion_list_workspaces 列出所有工作区
motion_get_workspace 获取工作区详细信息
motion_list_users 列出工作区用户
motion_get_current_user 获取当前用户
motion_list_comments 列出任务注释
motion_create_comment 添加任务注释
motion_list_recurring_tasks 列出重复任务
motion_create_recurring_task 创建定期任务
motion_delete_recurring_task 删除定期任务
motion_list_schedules 列出时间表

配置

变量 必填 默认 描述
MOTION_API_KEY ✅ - 您的运动API键
MOTION_BASE_URL ❌ https://api.usemotion.com/v1 API终点
RATE_LIMIT_WINDOW_MS ❌ 180000 速率限制窗口（3分钟）
RATE_LIMIT_MAX_REQUESTS ❌ 12 每个窗口的最大请求数
DATABASE_PATH ❌ ./motion-rate-limit.db SQLite数据库路径
DEBUG ❌ false 启用调试日志记录

发展

# Clone
git clone https://github.com/h3ro-dev/motion-mcp-server.git
cd motion-mcp-server

# Install
npm install

# Build
npm run build

# Test
npm test

# Run locally
MOTION_API_KEY=your-key npm start

故障排除

Common Issues

“无效的API密钥”

  • 检查API密钥是否正确
  • 确保没有多余的空间
  • 如果需要，重新生成密钥

“超出费率限制”

  • 服务器自动处理此问题
  • 等待时间显示错误
  • 检查 DATABASE_PATH 可写

“未找到任务”

  • 验证任务ID是否存在
  • 检查工作区访问权限
  • 任务可以存档

许可证

麻省理工学院©h3ro dev

链接

相关 MCP