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)

Project Management (5 tools)

Other Tools (8 tools)

配置

发展

# 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

链接

• 运动API文档
• MCP协议