Claude MCP Trello

这是一个提供与Trello看板交互工具的模型上下文协议（MCP）服务器。该服务器能够无缝集成Trello的API，并自动处理速率限制、类型安全性和错误处理。

<a href="https://glama.ai/mcp/servers/7vcnchsm63"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=412583596,3733598181&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Claude Trello MCP 服务器" /> </a>

功能

• 完整的Trello看板集成：与卡片、列表和看板活动进行交互
• 内置速率限制：遵守Trello的API限制（每个API密钥每10秒300次请求，每个令牌每10秒100次请求）
• 类型安全实现：使用TypeScript编写，具有全面的类型定义
• 输入验证：对所有API输入进行强大的验证
• 错误处理：带有详细信息的消息优雅地处理错误

可用工具

trello_get_cards_by_list

检索指定列表ID中的卡片列表。

{
  name: "trello_get_cards_by_list",
  arguments: {
    listId: string; // Trello列表ID
  }
}

trello_get_lists

检索看板中的所有列表。

{
  name: "trello_get_lists",
  arguments: {}
}

trello_get_recent_activity

检索最近的看板活动。limit参数可以指定要检索的数量（默认值：10）。

{
  name: "trello_get_recent_activity",
  arguments: {
    limit?: number; // 可选：要检索的活动数量
  }
}

trello_add_card

向指定列表添加卡片。

{
  name: "trello_add_card",
  arguments: {
    listId: string;       // 要添加到的列表ID
    name: string;         // 卡片标题
    description?: string; // 可选：卡片详情
    dueDate?: string;     // 可选：截止日期（例如ISO8601格式）
    labels?: string[];    // 可选：标签ID数组
  }
}

trello_update_card

更新卡片的内容。

{
  name: "trello_update_card",
  arguments: {
    cardId: string;       // 要更新的卡片ID
    name?: string;        // 可选：更新后的标题
    description?: string; // 可选：更新后的描述
    dueDate?: string;     // 可选：更新后的截止日期（例如ISO8601格式）
    labels?: string[];    // 可选：更新后的标签ID数组
  }
}

trello_archive_card

归档（关闭）指定的卡片。

{
  name: "trello_archive_card",
  arguments: {
    cardId: string; // 要归档的卡片ID
  }
}

trello_add_list

在看板中添加新的列表。

{
  name: "trello_add_list",
  arguments: {
    name: string; // 新列表的名称
  }
}

trello_archive_list

归档（关闭）指定的列表。

{
  name: "trello_archive_list",
  arguments: {
    listId: string; // 要归档的列表ID
  }
}

trello_get_my_cards

检索与您的账户相关的所有卡片。

{
  name: "trello_get_my_cards",
  arguments: {}
}

trello_search_all_boards

根据计划/权限，在工作区（组织）的所有看板之间执行跨看板搜索。

{
  name: "trello_search_all_boards",
  arguments: {
    query: string;   // 搜索关键词
    limit?: number;  // 可选：结果的最大数量（默认值：10）
  }
}

速率限制

服务器实现了令牌桶算法来处理速率限制，以符合Trello的API限制：

• 每个API密钥每10秒300次请求
• 每个令牌每10秒100次请求

速率限制会自动处理，如果达到限制，请求会被排队。

错误处理

服务器提供了各种情况下的详细错误消息：

• 输入参数无效
• 超出速率限制
• API认证错误
• 网络问题
• 看板/列表/卡片ID无效

开发

先决条件

• Node.js 16或更高版本
• npm 或 yarn

设置

1. 克隆仓库：

   git clone https://github.com/hrs-asano/claude-mcp-trello.git
   cd claude-mcp-trello
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

运行测试

npm test

与Claude Desktop集成

要将此MCP服务器与Claude Desktop集成，请在您的 ~/Library/Application\ Support/Claude/claude_desktop_config.json 文件中添加以下配置：

{
  "mcpServers": {
    "trello": {
      "command": "{YOUR_NODE_PATH}", // 例如：/opt/homebrew/bin/node
      "args": [
        "{YOUR_PATH}/claude-mcp-trello/build/index.js"
      ],
      "env": {
        "TRELLO_API_KEY": "{YOUR_KEY}",
        "TRELLO_TOKEN": "{YOUR_TOKEN}",
        "TRELLO_BOARD_ID": "{YOUR_BOARD_ID}"
      }
    }
  }
}

确保替换{YOUR_NODE_PATH}、{YOUR_PATH}、{YOUR_KEY}、{YOUR_TOKEN}和{YOUR_BOARD_ID}为您环境中的适当值。

贡献

欢迎贡献！请阅读我们的贡献指南，了解我们的行为准则以及提交拉取请求的过程。

许可证

本项目采用MIT许可证 - 查看LICENSE文件获取详细信息。

致谢

• 使用模型上下文协议SDK构建
• 使用Trello REST API