Motion MCP Server
2025.05.10
1
TypeScript任务管理项目管理AI 集成日程管理
Motion MCP Server 是一个开源项目，旨在通过 MCP 协议将 AI 助手与 Motion API 无缝集成，实现智能化的任务和项目管理。它提供了多种工具来访问 Motion API 的不同端点，并内置了速率限制功能以防止超出 API 配额。
View on GitHub
Overview
产品定位
Motion MCP Server 是一个开源项目，旨在通过 MCP 协议将 AI 助手与 Motion API 无缝集成，实现智能化的任务和项目管理。
核心功能
- 提供多种 MCP 工具访问 Motion API 的不同端点（项目、任务、用户等）。
- 自动速率限制，防止超出 Motion API 的配额（每 3 分钟 12 次调用）。
- 使用本地 SQLite 数据库持久化速率限制状态，支持服务器重启后保持状态。
适用场景
- 通过自然语言与 AI 助手交互管理 Motion 任务和项目。
- 需要智能调度和优先级管理的任务和项目场景。
- 需要与 Motion API 集成的自动化工作流。
工具列表
motion get_tasks: 获取任务列表。motion get_projects: 获取项目列表。motion get_users: 获取用户列表。
常见问题解答
ERR_DLOPEN_FAILED/NODE_MODULE_VERSION不匹配: 确保安装依赖时使用的 Node.js 版本与 MCP 客户端使用的版本一致。- API 密钥无效: 确保
MOTION_API_KEY环境变量已正确设置且密钥有效。 - 数据库问题: 如果怀疑数据库损坏，可以删除
.data/motion_api_ratelimit.sqlite文件，服务器会在下次启动时重新创建。
使用教程
使用依赖
- 确保已安装 Node.js，并使用与 MCP 客户端相同的版本。
bash nvm install 18.19.0 nvm use 18.19.0
安装教程
- 克隆仓库：
bash git clone <your_repository_url_here> cd motion_mcp_server - 安装依赖：
bash npm install - 配置 API 密钥：
bash export MOTION_API_KEY="your_motion_api_key_here" - 启动服务器：
bash npx tsx main.ts
调试方式
- 使用 MCP Inspector 调试：
bash npx @modelcontextprotocol/inspector --config "/path/to/your/Claude/claude_desktop_config.json" --server motion - 访问
http://127.0.0.1:6274进行调试。