克劳德·MCP·特雷洛
一个模型上下文协议 (MCP) 服务器，提供与 Trello 看板交互的工具。该服务器能够与 Trello 的 API 无缝集成，同时自动处理速率限制、类型安全和错误处理。
特征
完整的 Trello Board 集成：与卡片、列表和板活动进行交互
内置速率限制：遵守 Trello 的 API 限制（每个 API 密钥 300 个请求/10 秒，每个令牌 100 个请求/10 秒）
类型安全实现：用 TypeScript 编写，具有全面的类型定义
输入验证：对所有 API 输入进行强大的验证
错误处理：优雅的错误处理，提供信息丰富的消息
Related MCP server: Trello MCP Server with Python
可用工具
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文件。