Server Trello MCP

🚀 MCP 服務端 - Trello

MCP 服務端 - Trello 是一個基於 Model Context Protocol (MCP) 的服務器，它提供了與 Trello 看板交互的工具。該服務器能無縫集成到 Trello 的 API 中，還能自動處理速率限制、類型安全和錯誤處理等問題，為開發者提供了便捷的開發體驗。

🚀 快速開始

MCP 服務端 - Trello 可無縫集成 Trello API，自動處理速率限制、類型安全和錯誤處理。以下為您介紹使用前的安裝和配置步驟。

✨ 主要特性

• 完整的 Trello 看板集成：可與卡片、列表和看板活動進行交互。
• 內置速率限制：嚴格遵守 Trello 的 API 限制（每個 API 密鑰每 10 秒 300 次請求，每個令牌每 10 秒 100 次請求）。
• 類型安全實現：使用 TypeScript 編寫，並帶有全面的類型定義。
• 輸入驗證：對所有 API 輸入進行 robust 驗證。
• 錯誤處理：具備優雅的錯誤處理機制和詳細的錯誤信息。

📦 安裝指南

使用以下命令安裝 MCP 服務端 - Trello：

npm install @modelcontextprotocol/mcp-server-trello

📚 詳細文檔

配置

將服務器添加到您的 MCP 設置文件中，示例如下：

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-trello"],
      "env": {
        "TRELLO_API_KEY": "your-api-key", // 您的 Trello API 密鑰（從 https://trello.com/app-key 獲取）
        "TRELLO_TOKEN": "your-token",     // 您的 Trello 令牌
        "TRELLO_BOARD_ID": "your-board-id" // 您的 Trello 看板 ID
      }
    }
  }
}

必要的環境變量

• TRELLO_API_KEY：您的 Trello API 密鑰，可從 Trello 開發者網站 獲取。
• TRELLO_TOKEN：用於身份驗證的令牌，通過 OAuth 流程獲取。
• TRELLO_BOARD_ID：您要操作的 Trello 看板的唯一標識符。

可用工具

以下是服務器提供的主要功能：

創建看板

創建一個新的 Trello 看板，命令如下：

mcp trello create-board --name "我的新看板"

參數說明：

• --name：指定看板的名稱。

刪除看板

刪除指定的 Trello 看板，命令如下：

mcp trello delete-board --board-id "5a8b4e7a9d0ef356cccf17b"

參數說明：

• --board-id：要刪除的看板的唯一標識符。

創建列表

在指定的看板上創建一個新列表，命令如下：

mcp trello create-list --board-id "5a8b4e7a9d0ef356cccf17b" --name "待辦事項"

參數說明：

• --board-id：目標看板的唯一標識符。
• --name：指定列表的名稱。

刪除列表

刪除指定看板上的一個列表，命令如下：

mcp trello delete-list --list-id "5a8b4e7a9d0ef356cccf17c"

參數說明：

• --list-id：要刪除的列表的唯一標識符。

創建卡片

在指定的列表下創建一張新卡片，命令如下：

mcp trello create-card --list-id "5a8b4e7a9d0ef356cccf17c" --name "完成項目"

參數說明：

• --list-id：目標列表的唯一標識符。
• --name：指定卡片的名稱。

刪除卡片

刪除指定列表下的一張卡片，命令如下：

mcp trello delete-card --card-id "5a8b4e7a9d0ef356cccf17d"

參數說明：

• --card-id：要刪除的卡片的唯一標識符。

速率限制

本服務器實現了 Trello 的 API 速率限制策略：

• 每個 API 密鑰每 10 秒允許最多 300 次請求。
• 每個令牌每 10 秒允許最多 100 次請求。

超出限制的請求將被自動排隊處理，確保您不會因速率限制而受到影響。

錯誤處理

服務器提供以下錯誤處理機制：

• 輸入驗證錯誤：當輸入參數不符合要求時，返回詳細的驗證錯誤信息。
• API 錯誤：當調用 Trello API 失敗時，捕獲並重拋帶有原始錯誤信息的異常。
• 網絡錯誤：當發生網絡問題時，記錄錯誤日誌並在下次嘗試重新連接。

開發

先決條件

1. Node.js 和 npm 已安裝到您的系統中。
2. 熟悉 TypeScript 和命令行工具開發。

設置步驟

1. 克隆倉庫：

git clone https://github.com/modelcontextprotocol/server-trello.git
cd server-trello

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

運行測試

npm test

貢獻指南

歡迎貢獻！請閱讀我們的 貢獻指南 以瞭解代碼規範和提交 Pull Request 的流程。

📄 許可證

本項目使用 MIT 許可證，具體信息見 LICENSE 文件。

致謝

• 使用 模型上下文協議 SDK 構建
• 採用 Trello REST API