克劳德·MCP·特雷洛

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

特征

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

可用工具

`trello_get_cards_by_list`

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

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

`trello_get_lists`

检索板中的所有列表。

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

`trello_get_recent_activity`

检索最近的论坛活动。limit limit可以指定检索数量（默认值：10）。

{
  name: "trello_get_recent_activity",
  arguments: {
    limit?: number; // Optional: number of activities to retrieve
  }
}

`trello_add_card`

将卡片添加到指定列表。

{
  name: "trello_add_card",
  arguments: {
    listId: string;       // The ID of the list to add to
    name: string;         // The title of the card
    description?: string; // Optional: details of the card
    dueDate?: string;     // Optional: due date (e.g., ISO8601)
    labels?: string[];    // Optional: array of label IDs
  }
}

`trello_update_card`

更新卡片的内容。

{
  name: "trello_update_card",
  arguments: {
    cardId: string;       // The ID of the card to be updated
    name?: string;        // Optional: updated title
    description?: string; // Optional: updated description
    dueDate?: string;     // Optional: updated due date (e.g., ISO8601)
    labels?: string[];    // Optional: updated array of label IDs
  }
}

`trello_archive_card`

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

{
  name: "trello_archive_card",
  arguments: {
    cardId: string; // The ID of the card to archive
  }
}

`trello_add_list`

向公告板添加新列表。

{
  name: "trello_add_list",
  arguments: {
    name: string; // Name of the new list
  }
}

`trello_archive_list`

存档（关闭）指定列表。

{
  name: "trello_archive_list",
  arguments: {
    listId: string; // The ID of the list to archive
  }
}

`trello_get_my_cards`

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

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

`trello_search_all_boards`

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

{
  name: "trello_search_all_boards",
  arguments: {
    query: string;   // Search keyword
    limit?: number;  // Optional: max number of results (default: 10)
  }
}

速率限制

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

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

速率限制是自动处理的，如果达到限制，请求将排队。

错误处理

服务器针对各种场景提供了详细的错误消息：

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

发展

先决条件

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

设置

克隆存储库：
git clone https://github.com/hrs-asano/claude-mcp-trello.git cd claude-mcp-trello
安装依赖项：

npm install

构建项目：

npm run build

运行测试

npm test

与 Claude Desktop 集成

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

{
  "mcpServers": {
    "trello": {
      "command": "{YOUR_NODE_PATH}", // for example: /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} 替换为适合您环境的值。

贡献

欢迎贡献代码！请阅读我们的贡献指南，详细了解我们的行为准则以及提交 Pull Request 的流程。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

致谢

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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

模型上下文协议服务器提供与 Trello 板交互的工具，实现卡片、列表和活动的无缝管理，同时处理速率限制和类型安全。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Trello MCP Server
andypost
A
security
F
license
A
quality
Enables interaction with Trello boards, lists, and cards through Model Context Protocol (MCP) tools, leveraging TypeScript for type safety and asynchronous operations.
Last updated -
5
JavaScript
ConnectWise Manage MCP Server
ethangillani
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.
Last updated -
JavaScript
MIT License
Rember MCPofficial
rember
-
security
A
license
-
quality
A Model Context Protocol server that allows Claude to create flashcards for Rember, helping users study and remember information through spaced repetition reviews.
Last updated -
88
16
TypeScript
MIT License
NPM Sentinel MCP
Nekzus
A
security
A
license
A
quality
A Model Context Protocol server providing utility tools for development and testing, offering functionalities like personalized greetings, random card drawing, and datetime formatting with an extensible architecture.
Last updated -
19
464
2
TypeScript
MIT License

View all related MCP servers

Claude MCP Trello