delorenj/mcp-server-trello

A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards.

MCP Server Trello – 對 AI 友善的 Trello 橋接器

它是什麼 – 這是一個由 Bun 驅動的小型伺服器，實作了 Model Context Protocol (MCP)。它封裝了 Trello REST API，並公開了 57 個具型別的工具（例如 get_card、add_checklist_item、watch_card），讓 AI 代理可以像呼叫原生函式一樣使用它們。該伺服器處理身份驗證、速率限制、輸入驗證，並以 JSON 或可直接貼上的 Markdown 格式返回資料。

為什麼重要 – 許多 AI 代理框架（如 Claude Desktop、Cursor 等）需要一種可靠的方式來讀取/寫入團隊的專案看板。此伺服器讓代理能夠完全存取看板，無需撰寫自訂的 HTTP 程式碼，並提供了更高階的輔助功能，例如：

驗收標準提取（get_acceptance_criteria），自動找到正確的檢查清單（AC、DoD 等）並報告完成百分比。
監控工具（watch_card、watch_list），將 Trello 活動推送到代理的通知串流中。
動態看板/工作區切換，讓同一個伺服器可以在不重啟的情況下服務多個專案。

主要功能

卡片、清單、看板、檢查清單、評論、附件、標籤、自訂欄位的完整 CRUD 操作。
內建速率限制處理（每個 API 金鑰 300 次請求/10 秒，每個 Token 100 次請求/10 秒）。
具型別安全的 TypeScript 實作 – 代理可獲得適當的參數模式。
可選的環境變數沙箱（TRELLO_ALLOWED_WORKSPACES），用於多租戶安全性。
卡片資料的 Markdown 匯出，提供人類可讀的上下文。
作為單一 npm 套件（@delorenj/mcp-server-trello）分發，可使用 bunx 或 npx 啟動。

如何運行

安裝 – npm i -g @delorenj/mcp-server-trello（或直接在您的 MCP 客戶端中引用該套件；無需複製儲存庫）。
設定 – 建立包含 TRELLO_API_KEY 和 TRELLO_TOKEN 的 .env 檔案（可從 https://trello.com/app-key 取得）。可選變數可讓您設定預設看板、工作區、代理伺服器，或限制允許的工作區。

添加到 MCP 客戶端 – 例如在 Claude Desktop 的 mcpServers 設定中：

{
  "trello": {
    "command": "bunx",
    "args": ["@delorenj/mcp-server-trello"],
    "env": {"TRELLO_API_KEY": "…", "TRELLO_TOKEN": "…"}
  }
}

啟動 – bunx @delorenj/mcp-server-trello（或 npx …）。伺服器會向 MCP 註冊表註冊，因此任何支援註冊表的客戶端都可以自動發現它。
使用工具 – 代理透過名稱呼叫公開的工具，並使用 README 中顯示的 JSON 載入體（例如 { "name": "get_card", "arguments": { "cardId": "abc123" } }）。回應包含豐富的資料結構，並在要求時提供 Markdown 渲染。

技能套件 – 該儲存庫還附帶一個與 BMAD 相容的 skill 目錄。安裝此技能後，伺服器的工具將出現在代理的技能集中，且提供的 install.sh 腳本會在存在 Bun 的情況下在本地構建伺服器。

典型工作流程

1. list_boards → 選擇一個看板 ID
2. set_active_board (或 set_active_workspace)
3. get_card / get_checklist_items / get_acceptance_criteria
4. update_checklist_item / move_card / add_comment …
5. watch_card 以獲取即時更新

誰應該使用它 – 需要讀取或修改 Trello 看板的 AI 助理開發團隊（專案管理機器人、衝刺規劃代理、自動化回顧會議），以及任何希望擁有具型別、速率限制且符合 MCP 標準的介面，而非原始 HTTP 呼叫的人。

連結

npm: https://www.npmjs.com/package/@delorenj/mcp-server-trello
MCP 註冊表條目: https://registry.modelcontextprotocol.io/servers/io.github.delorenj/mcp-server-trello
演示徽章: https://glama.ai/mcp/servers/klqkamy7wt

delorenj/mcp-server-trello

MCP Server Trello – 對 AI 友善的 Trello 橋接器

相關