Teamwork MCP

Teamwork MCP是一個連接Teamwork API的服務器，提供簡化的接口來管理Teamwork項目和任務。

開發者工具 #項目管理 #任務管理 #團隊協作 #API集成 .TypeScript

評分 : 2.5分

下載量 : 8

更新時間 : 2025-04-28

什麼是Teamwork MCP?

Teamwork MCP是一箇中間服務器，它將複雜的Teamwork API轉換為簡單易用的接口，讓您無需技術背景也能輕鬆管理項目和任務。它特別適合與Cursor等開發工具集成，提高團隊協作效率。

如何使用Teamwork MCP?

只需簡單配置您的Teamwork賬戶信息，服務器就會自動連接並準備好所有功能。您可以通過命令行或直接集成到Cursor等開發工具中使用。

適用場景

特別適合開發團隊需要將項目管理與代碼開發工作流結合的場景，如：任務跟蹤、進度同步、團隊協作等。

主要功能

項目管理查看、創建和管理Teamwork中的項目

任務管理全面管理任務，包括創建、更新、刪除和查看任務詳情

人員管理管理團隊成員和他們在項目中的分配情況

項目報告獲取項目進度和團隊績效報告

無縫集成輕鬆與Cursor等開發工具集成

優勢與侷限性

優勢

簡化了Teamwork API的複雜性，提供更友好的接口

支持靈活的權限控制，可以精確控制可用功能

與開發工具深度集成，提高開發效率

提供豐富的項目數據統計和報告功能

侷限性

需要Teamwork賬戶和API訪問權限

部分高級功能需要Teamwork企業版支持

首次配置需要一些技術知識

如何使用

安裝準備

確保已安裝Node.js(推薦18+版本)和npm/yarn

獲取代碼

克隆倉庫到本地

安裝依賴

進入項目目錄並安裝所需依賴

配置賬戶

複製.env.example文件並填寫您的Teamwork賬戶信息

啟動服務器

運行服務器，準備好接收請求

使用案例

項目進度跟蹤開發團隊可以即時查看項目進度和任務完成情況

任務分配項目經理可以快速分配任務給團隊成員

團隊績效報告獲取團隊成員的工作效率和任務完成情況報告

常見問題

我需要什麼樣的Teamwork賬戶才能使用這個MCP服務器?

如何限制某些敏感操作(如刪除任務)?

我可以同時連接多個Teamwork賬戶嗎?

如何獲取項目的ID?

數據會緩存在本地嗎?

🚀 團隊合作工具 - 團隊工作 MCP 服務器

團隊工作 MCP 服務器是專為 Teamwork 平臺打造的集成模塊（MCP），可與 Cursor 等工具交互。藉助該 MCP，用戶能直接在 Teamwork 上執行各類任務與操作。

🚀 快速開始

本項目是為 Teamwork 平臺設計的集成模塊，能與其他工具交互，讓您在 Teamwork 上輕鬆完成各種任務。以下為您介紹具體的安裝和使用方法。

📦 安裝指南

使用 NPX （推薦）

最簡便的運行方式是使用 NPX：

npx teamwork-mcp

若需配置選項，可按如下操作：

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

構建應用

若您想自行構建代碼，可執行以下命令：

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 就能識別您的 Teamwork 項目，並與當前解決方案關聯，減少獲取項目和任務所需的 API 調用數量。

使用說明

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

版本低於 0.47：
1. 打開 Cursor 設置 > 功能 > MCP。
2. 點擊 "+ 添加新的 MCP 服務器"。
3. 輸入服務器名稱（例如："Teamwork API"）。
4. 選擇 "stdio" 作為傳輸類型。
5. 在命令字段中輸入：npx @vizioz/teamwork-mcp，並添加所需的命令行參數，如域名、用戶名和密碼。您還可在此處添加工具過濾選項：--allow=getProjects,getTasks 或 --deny=deleteTask。
6. 點擊 "添加"。
版本 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"
      ]
    }