Teamwork MCP

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

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

评分 : 2分

下载量 : 16

更新时间 : 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"
      ]
    }