Claude MCP Trello

Claude MCP Trello

site icon
2025.03.27 3
JavaScript项目管理团队协作任务跟踪交流协作
Claude MCP Trello 是一个基于 Model Context Protocol (MCP) 的服务,专门用于与 Trello 看板进行交互。该服务通过自动处理速率限制、类型安全和错误处理,实现了与 Trello API 的无缝集成。
View on GitHub

Overview

基本能力

产品定位

Claude MCP Trello 是一个专门用于与 Trello 看板交互的 MCP 服务,旨在简化与 Trello API 的集成过程。

核心功能

  • 完整的 Trello 看板集成:可以与卡片、列表和看板活动进行交互
  • 内置速率限制:遵守 Trello API 的限制(每个 API 密钥 300 次请求/10秒,每个令牌 100 次请求/10秒)
  • 类型安全实现:使用 TypeScript 编写,具有全面的类型定义
  • 输入验证:对所有 API 输入进行健壮的验证
  • 错误处理:提供详细的错误信息和优雅的错误处理

适用场景

  • 项目管理工具集成
  • 自动化工作流程
  • 团队协作平台
  • 任务跟踪系统

工具列表

  1. trello_get_cards_by_list:检索指定列表 ID 中包含的卡片列表
  2. trello_get_lists:检索看板中的所有列表
  3. trello_get_recent_activity:检索最近的看板活动
  4. trello_add_card:向指定列表添加卡片
  5. trello_update_card:更新卡片内容
  6. trello_archive_card:归档指定卡片
  7. trello_add_list:向看板添加新列表
  8. trello_archive_list:归档指定列表
  9. trello_get_my_cards:检索与您账户相关的所有卡片
  10. trello_search_all_boards:跨工作区所有看板进行搜索

常见问题解答

  • 速率限制:自动处理,请求在达到限制时会排队
  • 错误处理:提供详细的错误消息,包括无效输入参数、速率限制超出、API 认证错误等

使用教程

使用依赖

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

安装教程

  1. 克隆仓库: bash git clone https://github.com/hrs-asano/claude-mcp-trello.git cd claude-mcp-trello
  2. 安装依赖: bash npm install
  3. 构建项目: bash npm run build

调试方式

运行测试:

npm test

与 Claude Desktop 集成

在 ~/Library/Application\ Support/Claude/claude_desktop_config.json 文件中添加配置:

{
  "mcpServers": {
    "trello": {
      "command": "{YOUR_NODE_PATH}",
      "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}"
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。