适合谁
- 需要 AI 代理访问 Trello 并管理项目任务的团队。
- 希望使用 AI 助手自动化看板工作流的开发者。
M
58FMRS · C
该服务器提供了全面的 Trello 集成，包含 57 种工具，涵盖清单、附件、评论和自定义字段管理。它支持动态看板和工作区选择，并内置速率限制。唯一潜在缺点是依赖 Bun 和需要高权限的 API 凭据。
一个 Model Context Protocol (MCP) 服务器，为 AI 代理提供对 Trello 看板的全面访问，包括卡片、列表、清单、附件、评论、自定义字段和工作区。内置速率限制、类型安全和工作流级工具，如验收标准提取和清单依赖查询。共 57 个工具，通过 npx 安装，基于 Bun 构建。
工具能力
get_checklist_items
按名称获取清单中的所有项目。
add_checklist_item
向现有清单添加新项目。
find_checklist_items_by_description
搜索包含特定文本的清单项目。
get_acceptance_criteria
获取“验收标准”清单中的所有项目。
get_checklist_by_name
获取完整清单，包括所有项目和完成百分比。
update_checklist_item
更新现有清单项目。
delete_checklist_item
删除现有清单项目。
get_card
获取指定 Trello 卡片的详细完整信息。
get_cards_by_list_id
从特定列表获取所有卡片。
get_lists
从看板获取所有列表。
get_recent_activity
获取看板上的最近活动。
add_card_to_list
向指定列表添加新卡片。
update_card_details
更新现有卡片的详情。
archive_card
将卡片存档。
add_list_to_board
向看板添加新列表。
archive_list
将列表存档。
update_list
更新列表的名称、存档状态、订阅状态或所属看板。
update_list_position
更新列表在看板上的位置。
get_my_cards
获取分配给当前用户的所有卡片。
move_card
将卡片移动到不同的列表。
attach_image_to_card
从 URL 将图像附加到卡片。
attach_file_to_card
从 URL 或本地文件路径将任意类型文件附加到卡片。
download_attachment
按 ID 下载卡片中的附件。
add_comment
向 Trello 卡片添加评论。
update_comment
更新卡片上的现有评论。
delete_comment
从卡片中删除评论。
get_card_comments
获取特定卡片的所有评论。
list_boards
列出用户有权访问的所有看板。
set_active_board
设置活跃看板以供后续操作使用。
list_workspaces
列出用户有权访问的所有工作区。
set_active_workspace
设置活跃工作区以供后续操作使用。
list_boards_in_workspace
列出特定工作区中的所有看板。
get_active_board_info
获取当前活跃看板的信息。
get_board_custom_fields
获取看板上所有自定义字段的定义。
update_card_custom_field
设置或清除卡片上的自定义字段值。
安装接入
- 在 Trello 获取 API 密钥和令牌：访问 https://trello.com/app-key。
- 在 MCP 客户端配置中添加服务器，例如 Claude Desktop 的配置。
- 使用 bunx 或 npx 启动服务器，并设置环境变量 TRELLO_API_KEY 和 TRELLO_TOKEN。
claude_desktop_config.json
{
"mcpServers": {
"trello": {
"command": "bunx",
"args": [
"@delorenj/mcp-server-trello"
],
"env": {
"TRELLO_API_KEY": "your-trello-api-key",
"TRELLO_TOKEN": "your-trello-token"
}
}
}
}
选型与风险
不适合谁
- 不需要 Trello 的实时交互，僅需只读访问的场景。
- 对性能要求极高，且无法接受 Bun 依赖的环境。
所需权限
- 需要 Trello API 密钥和令牌，允许服务器代表用户访问 Trello 数据。
- 默认可以访问令牌权限范围内的所有看板和工作区。
- 可选限制访问特定工作区（通过环境变量 TRELLO_ALLOWED_WORKSPACES）。
风险与副作用
- API 凭据泄露风险，需妥善保管密钥和令牌。
- AI 可能误操作，如意外删除卡片或评论。
- 不当使用可能触发 Trello 速率限制。
常见排障
- 常见问题检查： - 确认 TRELLO_API_KEY 和 TRELLO_TOKEN 正确无误。 - 检查网络连接，确保能访问 Trello API。 - 如遇速率限制，等待稍后重试。 - 查看错误消息，确认提供的看板、列表或卡片 ID 是否正确。
使用场景
通过 AI 助手管理看板、列表和卡片。
从卡片中提取验收标准。
自动化评论和附件操作。
在多个工作区和看板之间切换。
支持客户端
Claude Desktop完整支持