Teamwork MCP

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

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

評分 : 2分

下載量 : 9

更新時間 : 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"
      ]
    }