Teamwork MCP

简介

Teamwork MCP 是一个连接 Teamwork API 的服务器，提供简化接口来管理项目和任务。它通过 MCP 协议与 Cursor 和其他应用程序集成。

安装

git clone https://github.com/readingdancer/teamwork-mcp.git
cd teamwork-mcp
npm install
cp .env.example .env  # 并编辑凭证信息

配置

环境设置（选择一种方法）

1. 使用.env文件：

   TEAMWORK_DOMAIN=your-company
   TEAMWORK_USERNAME=your-email@example.com
   TEAMWORK_PASSWORD=your-password
   

2. 命令行参数：

   node build/index.js --domain=your-company --user=email@example.com --pass=your-password
   

3. 环境变量：设置TEAMWORK_DOMAIN，TEAMWORK_USERNAME，TEAMWORK_PASSWORD

项目关联

在项目根目录创建.teamwork文件：

PROJECT_ID = YourTeamworkProjectID

启动服务器

npm run build
node build/index.js  # 如果已配置.env

添加到Cursor

Cursor 0.47版本前

1. 打开设置 > 功能 > MCP
2. 点击"+ 添加新的MCP服务器"
3. 设置服务器名称（例如"Teamwork API"）
4. 传输类型选择"stdio"
5. 命令：node C:/your-path/build/index.js
6. 点击"添加"

Cursor 0.47版本后（编辑配置）

"Teamwork-MCP": {
  "command": "node",
  "args": [
    "C:/your-path/build/index.js"
  ]
}

工具过滤（可选）

限制可用工具：

node build/index.js --allow=getProjects,getTasks,getTaskById

或排除特定工具：

node build/index.js --deny=deleteTask,updateTask

主要功能

• 项目操作: getCurrentProject, getProjects, createProject
• 任务管理: getTasks, createTask, updateTask, deleteTask
• 人员管理: getPeople, getProjectPeople, addPeopleToProject
• 报告工具: getTasksMetricsComplete, getTasksMetricsLate

系统要求

• Node.js v14.17+（推荐18+或LTS版本）
• npm或yarn
• 有API访问权限的Teamwork账户

许可

MIT许可协议