MCP Server Trello

🚀 MCP 服務器 - Trello

MCP 服務器 - Trello 是一個基於 Model Context Protocol (MCP) 的服務器，它為用戶提供了與 Trello 看板進行交互的強大工具。該服務器在集成 Trello API 時，能夠自動處理速率限制、確保類型安全並進行有效的錯誤處理，極大地提升了開發效率和使用體驗。

🚀 快速開始

MCP 服務器 - Trello 可以幫助您輕鬆與 Trello 看板進行交互。您可以通過以下步驟快速開始使用：

1. 安裝服務器。
2. 配置服務器的相關參數。
3. 利用提供的工具進行看板操作。

✨ 主要特性

• 完整的 Trello 看板集成：支持與卡片、列表和看板活動進行全面交互。
• 內置速率限制：嚴格遵循 Trello 的 API 限制（每個 API 鍵 300 次請求/10 秒，每個令牌 100 次請求/10 秒），同時服務器自身每分鐘最多處理 50 個請求，防止濫用並確保穩定性。
• 類型安全實現：採用 TypeScript 編寫，具備全面的類型定義，提高代碼的可靠性和可維護性。
• 輸入驗證：對所有 API 輸入進行穩健驗證，確保數據的有效性。
• 錯誤處理：實現了優雅的錯誤處理機制，並提供詳細的錯誤消息，同時所有 API 調用帶有重試機制（最多 3 次），失敗時會記錄錯誤日誌。

📦 安裝指南

您可以使用以下命令安裝 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 鍵
        "TRELLO_TOKEN": "your-token",     // 您的 Trello 令牌
        "TRELLO_BOARD_ID": "your-board-id" // 配置的 Trello 看板 ID
      }
    }
  }
}

可用工具

以下是服務器提供的功能及其使用示例：

獲取看板信息

// 獲取指定看板的基本信息
const board = await trello.getBoard(boardId);
// 返回值：包含看板名稱、描述和成員等信息的對象

創建新列表

// 在指定看板上創建一個新列表
const newList = await trello.createList(boardId, "任務清單");

添加卡片到列表

// 將卡片添加到指定列表中
const card = await trello.addCardToList(listId, "完成項目");

速率限制

服務器每分鐘最多處理 50 個請求，以防止濫用和確保穩定性。

錯誤處理

所有 API 調用都帶有重試機制（最多 3 次），並在失敗時記錄錯誤日誌。

💻 使用示例

基礎用法

// 獲取指定看板的基本信息
const board = await trello.getBoard(boardId);
// 返回值：包含看板名稱、描述和成員等信息的對象

高級用法

// 在指定看板上創建一個新列表，並將卡片添加到該列表中
const newList = await trello.createList(boardId, "任務清單");
const card = await trello.addCardToList(newList.id, "完成項目");

🔧 技術細節

克隆倉庫

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

安裝依賴

npm install

構建項目

npm run build

運行測試

npm test

📄 許可證

此項目使用 MIT 許可證，具體內容在 LICENSE 文件中。

致謝

• 使用 Model Context Protocol SDK
• 基於 Trello REST API 構建