运动MCP服务器
非官方 模型上下文协议（MCP）服务器 运动 -基于人工智能的日历、任务管理和项目规划应用程序，可以自动安排您的工作。
备注：这是一个社区构建的集成，而不是官方的Motion产品。我们创建了这个MCP服务器，因为没有可用的官方实现，使像Claude这样的人工智能助手能够与Motion强大的调度和任务管理功能进行交互。
 ](https://modelcontextprotocol.io) ](https://nodejs.org)
快速开始
步骤1：获取你的运动API密钥
- 登录到 运动
- 导航到“设置”→ API
- 创建新的API密钥
- 立即复制密钥（只显示一次！）
步骤2：安装MCP服务器
运行此命令将Motion MCP服务器添加到Claude：
claude mcp add motion npx -- -y @rf-d/motion-mcp步骤3：添加您的API密钥
上面的命令创建配置，但您需要手动添加API密钥：
- 打开您的Claude配置文件：
- macOS: ~/Library/Application Support/Claude/claude.json - 视窗: %APPDATA%\Claude\claude.json - Linux: ~/.config/claude/claude.json
- 查找
motion刚刚添加的条目，并将其更新为包含您的API密钥：
{
"mcpServers": {
"motion": {
"command": "npx",
"args": ["-y", "@rf-d/motion-mcp"],
"env": {
"MOTION_API_KEY": "your_motion_api_key_here"
}
}
}
}- 保存文件并重新启动Claude Desktop
替代安装方法
通过GitHub（开发）
git clone https://github.com/RF-D/motion-mcp.git
cd motion-mcp
npm install
npm run build
# Create a .env file with your API key
echo "MOTION_API_KEY=your_motion_api_key_here" > .env
# Run in development mode
npm run dev手动配置
如果您更喜欢在不使用CLI的情况下手动配置，请将其添加到您的 claude.json:
{
"mcpServers": {
"motion": {
"command": "npx",
"args": ["-y", "@rf-d/motion-mcp"],
"env": {
"MOTION_API_KEY": "your_motion_api_key_here",
"MOTION_RATE_LIMIT_PER_MINUTE": "12" // 12 for individual, 120 for teams
}
}
}
}特性
核心能力
- 任务管理：创建、更新、删除和组织任务，完全支持Motion的自动调度
- 项目管理：使用自定义状态跨工作区管理项目
- 工作区组织：访问和管理多个工作区
- 团队协作：用户管理、任务分配和团队协调
- 评论：添加和管理任务注释以实现更好的协作
- 调度：使用Motion的智能日程安排查看和管理日程
- 自定义字段：为任务和项目创建和管理自定义字段
- 周期性任务：以灵活的模式设置和管理重复任务
速率限制
服务器包括自动速率限制，以符合Motion的API限制：
- 个人账户：每分钟12个请求
- 团队帐户：每分钟120个请求
- 企业帐户：自定义限制
可用工具
任务管理（8个工具）
motion_list_tasks-列出具有过滤和分页功能的任务motion_get_task-获取详细的任务信息motion_create_task-使用自动日程安排创建新任务motion_update_task-更新任务属性motion_delete_task-删除任务motion_move_task-在项目之间移动任务motion_complete_task-将任务标记为已完成motion_uncomplete_task-将任务标记为未完成
项目管理（5个工具）
motion_list_projects-列出所有项目motion_get_project-获取项目详细信息motion_create_project-创建新项目motion_update_project-更新项目信息motion_delete_project-删除项目
工作区工具（2个工具）
motion_list_workspaces-列出可访问的工作区motion_get_workspace-获取工作区详细信息
附加工具（17个工具）
- 用户管理（3个工具）
- 进度管理（1个工具）
- 评论管理（5个工具）
- 自定义字段管理（5个工具）
- 重复任务管理（5个工具）
使用示例
基本任务创建
Create a new task called "Review Q4 reports" due tomorrow with high priority高级任务管理
List all my incomplete tasks in the "Development" project and move any bug fixes to high priority团队协作
Show me all tasks assigned to the team this week and add a comment to each one about the sprint goals周期性任务
Create a weekly recurring task for team standup meetings every Monday at 9 AM发展
先决条件
- Node.js>=20.0.0
- npm或纱线
- 运动API键
设置
# Clone the repository
git clone https://github.com/RF-D/motion-mcp.git
cd motion-mcp
# Install dependencies
npm install
# Set up environment
cp .env.example .env
# Edit .env with your API key
# Run in development mode
npm run dev脚本
npm run build-为生产而建npm run dev-热装开发模式npm run typecheck-TypeScript类型检查npm run lint-ESLint代码过滤npm run format-预处理代码格式
项目结构
src/
├── api/
│ └── client.ts # Motion API client with rate limiting
├── tools/
│ ├── task.ts # Task management tools
│ ├── project.ts # Project management tools
│ ├── workspace.ts # Workspace tools
│ └── ... # Other tool categories
├── types/
│ ├── motion.ts # Motion API type definitions
│ └── tool.ts # MCP tool type definitions
├── config.ts # Configuration management
└── index.ts # Main server entry point贡献
欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。
指南
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
请确保：
- 所有测试均通过
- 代码遵循现有样式
- TypeScript类型定义正确
- 文档已更新
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
资源
免责声明
这是一个非官方的整合，与Motion无关，也没有得到Motion的正式维护或认可。请自行决定使用。
故障排除
常见问题
“找不到运动API键”错误
- 确保您已添加
MOTION_API_KEY到claude.json配置 - 验证密钥是否正确且未过期
- 添加密钥后重新启动Claude Desktop
“超出速率限制”错误
- 个人账户每分钟仅限12个请求
- 团队帐户每分钟收到120个请求
- 服务器会自动处理速率限制，但非常频繁的使用仍可能达到限制
“找不到命令”错误
- 确保你安装了Node.js>=20.0.0
- 尝试使用完整路径运行：
npx @rf-d/motion-mcp
支持
- 问题:
- 讨论:
- NPM包:
______________________________________________________________________
出于对Motion和MCP社区的热爱而建立