关键词

Motion任务管理项目管理AI助手生产力

Motion MCP Server 使用说明

项目简介

Motion MCP Server 是一个开源的MCP (Model Context Protocol) 服务器实现，旨在连接您偏好的AI助手（如Claude Desktop、Cursor等）与强大的Motion任务和项目管理平台。通过将Motion API的功能封装成AI可调用的工具，您可以直接使用自然语言与AI交互，管理您的任务、项目和日程安排，从而提高工作效率。

主要功能点

  • AI驱动的任务/项目管理: 允许AI助手调用Motion API，执行创建、更新、检索任务和项目等操作。
  • 智能数据处理: 服务器会根据AI的需求（或使用默认设置）智能选择和格式化Motion API返回的数据字段，避免信息过载，提高AI处理效率。
  • 自动速率限制: 内置对Motion API调用频率的自动控制，避免超出Motion设置的速率限制（每3分钟12次调用）。
  • 持久化状态: 使用本地SQLite数据库存储速率限制信息，即使服务器重启也能保持状态。
  • 开放与可定制: 开源项目，您可以根据需要进行修改和扩展。

安装步骤

  1. 克隆仓库: 打开您的终端，克隆项目仓库。 
    git clone https://github.com/christopher-czaban/motion-mcp-server.git
cd motion-mcp-server
  2. 安装Node.js版本管理器 (推荐): 本项目依赖于特定的Node.js版本（通常与您的AI客户端所使用的版本一致），建议使用'nvm' (Node Version Manager) 或 'nvs' 等工具来管理Node.js版本，避免兼容性问题。
  3. 安装正确Node.js版本并使用: 根据您的AI客户端（如Claude Desktop）通常使用的Node.js版本（例如，v18.x或v20.x），使用版本管理器安装并切换到该版本。例如： 
    nvm install 18 # 安装最新的v18版本
nvm use 18     # 切换到v18版本
    如果您不确定客户端版本，可以尝试Node.js LTS版本。
  4. 安装项目依赖: 在确认终端使用了正确的Node.js版本后，安装项目依赖： 
    npm install
    重要: 如果将来更换了Node.js版本，可能需要重新安装或重建依赖 ('npm rebuild better-sqlite3 --update-binary')。
  5. 配置Motion API Key: 服务器需要您的Motion API Key才能与Motion API通信。您需要在AI客户端的MCP服务器配置中设置名为 'MOTION_API_KEY' 的环境变量。

服务器配置 (为您的MCP客户端提供)

您的AI客户端（如Claude Desktop、Cursor）需要配置才能找到并启动Motion MCP Server。典型的配置信息会包含在客户端的设置文件（通常是JSON格式）中，指定如何启动服务器进程。

您需要在客户端的MCP配置中添加一个服务器条目，例如命名为 "motion"。这个条目需要提供启动服务器的命令和参数。

以下是供您参考的配置结构的关键信息，您需要根据您的实际文件路径进行调整（请勿将以下代码直接粘贴到JSON文件中，这只是参数说明）：

  • server name: 您希望在客户端中显示的服务器名称，例如 '"motion"'。
  • command: 启动服务器的命令，通常是 '"npx"'。
  • args: 传递给 'command' 的参数数组。第一个参数通常是 '"tsx"' (用于直接运行TypeScript文件)，第二个参数是 Motion MCP Server仓库中 'main.ts' 文件的绝对路径。例如：'["tsx", "/path/to/your/motion-mcp-server/main.ts"]'。
  • env: 一个对象，用于设置服务器进程的环境变量。您需要在此设置您的Motion API Key：'{"MOTION_API_KEY": "YOUR_MOTION_API_KEY_HERE"}'。请将 '"YOUR_MOTION_API_KEY_HERE"' 替换为您的真实API Key。

配置完成后，请重启您的AI客户端，使配置生效。

基本使用方法

成功配置并启动Motion MCP Server后，您可以通过AI助手的聊天界面来使用它。AI助手会识别MCP服务器提供的工具（如获取任务、创建项目等）。

您只需用自然语言向AI助手提问或下达指令，AI会判断是否需要调用Motion MCP Server提供的工具，并自动构建参数、执行工具调用，然后将工具返回的结果（例如，任务列表、项目详情）呈现给您。

例如，您可以尝试说：“获取我所有进行中的任务”，或者“在我的工作空间'My Workspace'中创建一个新项目，名称是'整理季度报告'，优先级高，截止日期是下周五。” AI助手会根据您的指令调用相应的Motion MCP Server工具来完成操作。

故障排除

如果在设置或使用过程中遇到问题，最常见的是Node.js版本不匹配导致的错误（特别是 'ERR_DLOPEN_FAILED'）。请再次确认您的终端和AI客户端用于运行服务器的Node.js版本是否一致，并按照安装步骤重新执行 'npm install'。

贡献与许可证

本项目根据MIT许可证发布。欢迎通过GitHub issues报告问题或提出功能建议。

信息

分类

生产力应用

访问项目