Diegofornalha MCP Server Trello

🚀 MCP 服務器 Trello

MCP 服務器 Trello 是一個模型上下文協議（MCP）服務器，它提供了與 Trello 董事會交互的工具。該服務器在處理速率限制、類型安全和錯誤處理方面表現出色，能夠實現與 Trello API 的無縫集成。

🚀 快速開始

MCP 服務器 Trello 為開發者提供了便捷的方式與 Trello 董事會進行交互，以下是快速上手的步驟。

✨ 主要特性

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

📦 安裝指南

安裝依賴

npm install @modelcontextprotocol/mcp-server-trello

配置服務器

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

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-trello"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token",
        "TRELLO_BOARD_ID": "your-board-id"
      }
    }
  }
}

必要的環境變量

• TRELLO_API_KEY：您的 Trello API 密鑰（可從 https://trello.com/app-key 獲取）。
• TRELLO_TOKEN：您的 Trello 令牌（使用 API 密鑰生成）。
• TRELLO_BOARD_ID：要交互的 Trello 董事會 ID（在董事會 URL 中找到）。

💻 使用示例

基礎用法

get_cards_by_list_id

根據列表 ID 獲取所有卡片。

{
  name: 'get_cards_by_list_id',
  arguments: {
    listId: string  // 列表 ID
  }
}

get_lists

檢索配置的董事會中的所有列表。

{
  name: 'get_lists',
  arguments: {}
}

get_recent_activity

獲取董事會上的最近活動。

{
  name: 'get_recent_activity',
  arguments: {
    limit?: number  // 可選：要獲取的活動數量（默認值：10）
  }
}

add_card_to_list

將新卡片添加到指定列表中。

{
  name: 'add_card_to_list',
  arguments: {
    listId: string,       // 要添加卡片的列表 ID
    name: string,         // 卡片名稱
    description?: string, // 可選：卡片描述
    due?: Date,          // 可選：截止日期
    labels?: string[]     // 可選：標籤 ID 數組
  }
}

add_comment_to_card

在指定卡片下添加評論。

{
  name: 'add_comment_to_card',
  arguments: {
    cardId: string, // 卡片 ID
    text: string     // 評論文本
  }
}

📚 詳細文檔

速率限制

默認情況下，Trello API 的免費層限制為：

• 每分鐘 20 個請求。
• 每小時 1000 個請求。 如果您需要更高的速率限制，請考慮升級到付費計劃。

錯誤處理

所有 API 調用都會返回一個包含以下字段的對象：

{
  success: boolean,       // 表示操作是否成功的布爾值
  data?: any,           // 成功時的響應數據
  error?: {
    message: string      // 錯誤消息
  }
}

開發步驟

克隆倉庫

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

安裝依賴項

npm install

構建項目

npm run build

運行測試

npm test

貢獻

歡迎貢獻！請閱讀我們的貢獻指南以瞭解代碼規範和提交拉取請求的過程。

📄 許可證

此項目根據 MIT 許可證分發 - 有關詳細信息，請參閱LICENSE文件。

致謝

• 使用modelcontextprotocol SDK構建。
• 使用Trello REST API。