Teamwork MCP

Teamwork MCP是一个连接Teamwork API的服务器，提供简化的接口来管理项目、任务和人员。

开发者工具项目管理与协作 #项目管理 #任务跟踪 #团队协作 #API集成本地 .TypeScript

评分 : 2分

下载量 : 6.3K

更新时间 : 2025-04-23

打开站点

什么是Teamwork MCP?

Teamwork MCP是一个连接到Teamwork API的服务器，它提供了一个简单易用的界面来管理您的团队项目和任务。您可以轻松地创建、更新和删除任务，获取项目进度报告等。

如何使用Teamwork MCP?

首先安装并配置Teamwork MCP服务器，然后通过Cursor或其他MCP客户端将其添加到您的工作流程中。只需几步即可开始高效管理您的项目。

适用场景

适用于需要实时协作、跟踪任务状态以及生成项目报告的团队。无论是小型团队还是大型企业，都可以从中受益。

主要功能

项目工具

获取所有项目、查看当前项目详情、创建新项目等功能。

任务工具

创建、更新、删除任务；获取任务列表及子任务信息。

评论工具

为特定任务或消息添加评论。

公司工具

管理公司信息，如创建、更新或删除公司。

人员工具

分配人员到项目、查看绩效和利用率等。

报表工具

生成用户任务完成情况及项目利用率报告。

时间工具

记录和分析团队的时间分配。

优势

无缝集成Teamwork API，操作简便。

支持多种工具过滤选项，灵活性强。

强大的日志和错误处理机制，确保稳定运行。

开源且免费使用，无需额外费用。

局限性

需要Teamwork账户才能正常工作。

某些高级功能可能依赖于Teamwork的API限制。

初次配置可能稍显复杂，需熟悉命令行操作。

如何使用

安装Teamwork MCP

克隆仓库并安装依赖包： ```bash git clone https://github.com/readingdancer/teamwork-mcp.git cd teamwork-mcp npm install ```

配置环境变量

创建.env文件并填写必要信息，例如域名、用户名和密码。

启动服务器

使用以下命令启动服务器： ```bash node build/index.js ```

添加到Cursor

在Cursor设置中添加MCP服务器，并输入相应的命令行参数。

使用案例

创建新项目

通过Teamwork MCP创建一个全新的项目。

更新任务状态

将某个任务标记为已完成。

生成利用率报告

导出整个团队的任务利用率报告。

常见问题

如何确保我的API凭证安全？

如果忘记了Teamwork密码怎么办？

是否支持多语言界面？

🚀 团队合作 MCP 项目文档

Teamwork MCP 是一款与 Teamwork.com 平台集成的工具，为 Cursor 等 MCP 客户端提供支持。它采用 TypeScript 编写，拥有丰富的 API 方法，可用于交互和管理 Teamwork 项目、任务及其他资源。

🚀 快速开始

Teamwork MCP 能帮助你轻松与 Teamwork.com 平台集成，为 MCP 客户端提供支持。下面为你介绍如何快速开启使用之旅。

✨ 主要特性

与 Teamwork.com 平台集成，为 Cursor 等 MCP 客户端提供支持。
使用 TypeScript 编写，提供丰富的 API 方法用于交互和管理 Teamwork 项目、任务和其他资源。

📦 安装指南

使用 NPX（推荐）

最简单的使用方式是通过 NPX 运行：

npx teamwork-mcp

你还能通过传递配置选项来运行：

npx teamwork-mcp --domain=your-company --user=your-email@example.com --pass=your-password

构建应用

注意：若你仅想使用 MCP，可直接使用 NPX 指令，无需构建。 构建应用的命令如下：

npm run build

此命令会编译 TypeScript 代码，以便作为 MCP 服务器运行。

运行 MCP 服务器

若你想以 MCP 服务器的形式运行该项目（用于与其他应用程序集成）： 假设你已使用 .env 文件保存用户名、密码和 URL，或者已将其设置为环境变量：

node C:/your-full-path/build/index.js

或者你可以通过命令行参数传递它们：

node C:/your-full-path/build/index.js --teamwork-domain=your-company --teamwork-username=your-email@example.com --teamwork-password=your-password

你也能使用简写形式：

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

使用 MCP 检查工具（用于调试）

要运行 MCP 检查工具进行调试，可执行以下命令：

npm run inspector

📚 详细文档

配置 Teamwork 项目

为了将你的解决方案与 Teamwork 项目关联，可在项目根目录创建一个 .teamwork 文件，结构如下：

PROJECT_ID = YourTeamworkProjectID

此配置文件用于标识你的解决方案对应的 Teamwork 项目，未来可能会添加更多详细信息。配置完成后，MCP 将能够自动识别你的项目，并减少获取项目和相关任务所需的 API 调用数量。

使用说明

添加到 Cursor（及其他 MCP 客户端）

如果你使用的是 Cursor 的早期版本（0.47 以下）：

打开 Cursor 设置 > 功能 > MCP。
点击“+ 添加新 MCP 服务器”。
输入服务器名称（例如：“Teamwork API”）。
选择传输类型为“stdio”。
在命令行中输入运行服务器的命令：npx @vizioz/teamwork-mcp，并添加所需的凭证和域命令行参数。
- 你可以通过 --allow=getProjects,getTasks 或 --deny=deleteTask 等选项进行工具过滤。
点击“添加”。

如果你使用的是 Cursor 的版本 0.47 或以上（手动编辑配置文件）：

    "Teamwork": {
      "command": "npx",
      "args": [
        "-y",
        "@vizioz/teamwork-mcp",
        "--domain",
        "yourdomain",
        "--user",
        "youruser@yourdomain.com",
        "--pass",
        "yourPassword"
      ]
    }

如果你想添加工具过滤选项，可以这样做：

    "Teamwork": {
      "command": "npx",
      "args": [
        "-y",
        "@vizioz/teamwork-mcp",
        "--domain",
        "yourdomain",
        "--user",
        "youruser@yourdomain.com",
        "--pass",
        "yourPassword",
        "--allow",
        "Tasks,Projects",
        "--deny",
        "getProjectsPeopleMetricsPerformance,getProjectsPeopleUtilization"
      ]
    }