Delorenj MCP Server Trello

🚀 MCP 服務器 Trello

MCP 服務器 Trello 是一款基於模型上下文協議（MCP）的服務器，它提供了與 Trello 看板交互的工具。該服務器實現了處理速率限制、類型安全和錯誤處理的自動化，可與 Trello API 實現無縫集成。

🚀 快速開始

MCP 服務器 Trello 為用戶提供了與 Trello 看板交互的便捷途徑，實現了速率限制、類型安全和錯誤處理的自動化，同時支持與 Trello API 的無縫集成。

✨ 主要特性

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

📦 安裝指南

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

npm install @modelcontextprotocol/mcp-server-trello

📚 詳細文檔

配置

將服務器添加到您的 MCP 設置文件中，並進行如下配置：

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-trello"],
      "env": {
        "TRELLO_API_KEY": "你的API密鑰", // 獲取自 https://trello.com/app-key
        "TRELLO_TOKEN": "你的令牌",     // 使用你的API密鑰生成
        "TRELLO_BOARD_ID": "你的看板ID"  // 在看板URL中找到
      }
    }
  }
}

必需的環境變量

• 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
    cardData: {
      idList: string,
      name: string,
      desc?: string,
      pos?: number,
      due?: string,
      dueComplete?: boolean,
      labels?: string[],
      members?: string[],
      comments?: {
        text: string
      }[]
    }
  }
}

update_card

更新現有卡片的信息。

{
  name: 'update_card',
  arguments: {
    cardId: string, // 卡片ID
    cardData: {
      idList?: string,
      name?: string,
      desc?: string,
      pos?: number,
      due?: string,
      dueComplete?: boolean,
      labels?: string[],
      members?: string[],
      comments?: {
        text: string
      }[]
    }
  }
}

delete_card

刪除指定卡片。

{
  name: 'delete_card',
  arguments: {
    cardId: string // 卡片ID
  }
}

速率限制

• 每個 API 密鑰每 10 秒：300 個請求。
• 每個令牌每 10 秒：100 個請求。

📄 許可證

此項目在 MIT License 下許可，詳情請參閱 LICENSE 文件。

💡 貢獻

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