Claude MCP Trello

一个模型上下文协议 (MCP) 服务器，提供与 Trello 看板交互的工具。此服务器实现了与 Trello API 的无缝集成，同时自动处理速率限制、类型安全和错误处理。

<a href="https://glama.ai/mcp/servers/7vcnchsm63"> <img width="380" height="200" src="https://glama.ai/mcp/servers/7vcnchsm63/badge" alt="Claude Trello MCP server" /> </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