项目介绍
Motion MCP 服务器
非官方 Model Context Protocol (MCP) 服务器用于 Motion — 这是一款由AI驱动的日历、任务管理和项目规划应用程序，能够自动安排您的工作。
注意：这是一个社区构建的集成，不是官方的Motion产品。我们创建这个MCP服务器是因为没有官方实现可用，使像Claude这样的AI助手能够与Motion的强大调度和任务管理功能进行交互。
快速开始
第一步：获取您的Motion API密钥
- 登录到 Motion
- 导航至设置 → API
- 创建一个新的API密钥
- 立即复制该密钥（它只会显示一次！）
第二步：安装MCP服务器
运行以下命令以将Motion MCP服务器添加到Claude：
claude mcp add motion npx -- -y @rf-d/motion-mcp
第三步：添加您的API密钥
上述命令会创建配置文件，但您需要手动添加您的API密钥：
-
打开您的Claude配置文件：
- macOS：
~/Library/Application Support/Claude/claude.json - Windows：
%APPDATA%\Claude\claude.json - Linux：
~/.config/claude/claude.json
- macOS：
-
查找刚刚添加的
motion条目，并更新以包含您的API密钥：
{
"mcpServers": {
"motion": {
"command": "npx",
"args": ["-y", "@rf-d/motion-mcp"],
"env": {
"MOTION_API_KEY": "your_motion_api_key_here"
}
}
}
}
- 保存文件并重启Claude桌面应用
其他安装方法
通过GitHub（开发）
git clone https://github.com/RF-D/motion-mcp.git
cd motion-mcp
npm install
npm run build
# 创建一个包含您的API密钥的.env文件
echo "MOTION_API_KEY=your_motion_api_key_here" > .env
# 在开发模式下运行
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次/分钟，团队账户120次/分钟
}
}
}
}
功能
核心能力
- 任务管理：创建、更新、删除和组织任务，完全支持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个工具）
使用示例
基本任务创建
创建一个名为“审查Q4报告”的新任务，定于明天完成，优先级高
高级任务管理
列出我在“开发”项目中的所有未完成任务，并将任何bug修复任务标记为高优先级
团队协作
显示本周分配给团队的所有任务，并在每个任务上添加关于冲刺目标的评论
重复任务
创建每周一次的团队站会会议任务，每周一上午9点
开发
先决条件
- Node.js >= 20.0.0
- npm 或 yarn
- Motion API密钥
设置
# 克隆仓库
git clone https://github.com/RF-D/motion-mcp.git
cd motion-mcp
# 安装依赖
npm install
# 设置环境
cp .env.example .env
# 编辑.env文件，添加您的API密钥
# 在开发模式下运行
npm run dev
脚本
npm run build- 构建生产版本npm run dev- 开发模式，支持热重载npm run typecheck- TypeScript类型检查npm run lint- ESLint代码检查npm run format- Prettier代码格式化
项目结构
src/
├── api/
│ └── client.ts # 带有速率限制的Motion API客户端
├── tools/
│ ├── task.ts # 任务管理工具
│ ├── project.ts # 项目管理工具
│ ├── workspace.ts # 工作区工具
│ └── ... # 其他工具类别
├── types/
│ ├── motion.ts # Motion API类型定义
│ └── tool.ts # MCP工具类型定义
├── config.ts # 配置管理
└── index.ts # 主服务器入口点
贡献
欢迎贡献！请随时提交Pull Request。对于重大更改，请先打开一个问题来讨论您想要更改的内容。
指南
- 分叉仓库
- 创建您的功能分支 (
git checkout -b feature/amazing-feature) - 提交您的更改 (
git commit -m '添加精彩功能') - 推送到分支 (
git push origin feature/amazing-feature) - 打开Pull Request
请确保：
- 所有测试通过
- 代码遵循现有风格
- TypeScript类型正确定义
- 文档已更新
许可证
此项目采用MIT许可证 - 详情见LICENSE文件。
资源
免责声明
这是一个非官方集成，与Motion无关，未经官方维护或认可。请自行决定使用。
故障排除
常见问题
“Motion API密钥未找到”错误
- 确保您已在claude.json配置中添加了
MOTION_API_KEY - 验证密钥是否正确且未过期
- 添加密钥后重新启动Claude桌面应用
“超出速率限制”错误
- 个人账户每分钟限12次请求
- 团队账户每分钟限120次请求
- 服务器自动处理速率限制，但非常频繁的使用仍可能达到限制
“命令未找到”错误
- 确保您已安装Node.js >= 20.0.0
- 尝试使用完整路径运行：
npx @rf-d/motion-mcp
支持
为Motion和MCP社区倾情打造