1. 服务概述
一句话简介:本地MCP服务器,让Claude Code管理Trello工单 - 包括看板、列表、卡片、评论、检查清单、标签和成员
- 服务名称:trello-mcp
- 版本号:最新版本
- 开发者/提供方:Artemnikov
- 协议类型:MCP (Model Context Protocol)
2. 核心功能
trello-mcp提供以下主要功能:
- 看板管理:列出和查看Trello看板信息
- 列表管理:查看看板中的列表
- 卡片管理:创建、更新、移动、归档卡片
- 评论功能:为卡片添加评论
- 检查清单:创建检查清单、添加检查项、设置检查状态
- 标签管理:列出现有标签、为卡片添加标签
- 成员管理:查看看板成员、为卡片分配成员
3. 使用场景
trello-mcp适用于以下场景:
- 项目管理:通过自然语言管理Trello看板和项目进度
- 任务跟踪:创建、更新和跟踪任务卡片
- 团队协作:分配任务给团队成员,添加评论和标签
- 工作流自动化:自动创建和移动卡片,管理检查清单
- 进度监控:查看看板状态,检查任务完成情况
- 文档管理:为任务添加详细描述和附件链接
4. 接入方式
4.1 服务端点
trello-mcp采用本地stdio连接方式:
- 协议:stdio(标准输入输出)
- 运行方式:本地Python进程
- 客户端:Claude Code、Claude Desktop等MCP兼容客户端
4.2 认证与权限
trello-mcp使用Trello API进行认证:
- API密钥:从Trello Power-Up管理页面获取
- 令牌:通过授权URL获取(非OAuth密钥)
- 权限范围:读写权限(read, write)
- 有效期:永不过期(expiration=never)
4.3 数据格式
支持以下数据格式:
- 看板信息:ID、名称、描述
- 列表信息:ID、名称、位置
- 卡片信息:ID、名称、描述、截止日期、标签
- 检查清单:检查项列表和完成状态
4.4 服务器配置
环境变量配置(.env文件):
TRELLO_API_KEY=your_api_key_here TRELLO_TOKEN=your_token_here TRELLO_DEFAULT_BOARD=optional_default_board_idClaude Code配置:
claude mcp add trello --scope user -- \ uv run --directory "$(pwd)" trello-mcp5. 接口定义
trello-mcp提供16个工具接口:
| 工具名称 | 功能描述 | 类型 |
|---|---|---|
list_boards | 列出所有看板 | 读取 |
list_lists | 列出现有列表 | 读取 |
list_cards | 列出卡片 | 读取 |
get_card | 获取单个卡片详情 | 读取 |
list_labels | 列出标签 | 读取 |
list_board_members | 列出现有看板成员 | 读取 |
create_card | 创建新卡片 | 创建 |
update_card | 更新卡片信息 | 更新 |
move_card | 移动卡片到其他列表 | 更新 |
archive_card | 归档卡片 | 删除 |
add_comment | 为卡片添加评论 | 注释 |
add_checklist | 添加检查清单 | 注释 |
add_checklist_item | 添加检查项 | 注释 |
set_check_item | 设置检查项状态 | 注释 |
add_label | 为卡片添加标签 | 注释 |
assign_member | 为卡片分配成员 | 注释 |
6. 快速开始
6.1 环境要求
- Python 3.8或更高版本
- uv包管理器
- Trello账户和API访问权限
- MCP兼容客户端(Claude Code、Claude Desktop等)
6.2 示例代码
步骤1:获取API密钥和令牌
# 访问授权URL(替换<API_KEY>) https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=ClaudeMCP&key=<API_KEY> # 批准授权后,复制生成的令牌步骤2:配置环境变量
cp .env.example .env # 编辑.env文件,粘贴TRELLO_API_KEY和TRELLO_TOKEN步骤3:安装依赖
uv sync步骤4:注册到Claude Code
claude mcp add trello --scope user -- \ uv run --directory "$(pwd)" trello-mcp # 验证安装 claude mcp list使用示例对话:
# 列出看板 "列出我的所有Trello看板" # 创建卡片 "在我的项目看板中创建一个新卡片,标题是'完成文档编写',描述是'需要在周五前完成技术文档'" # 移动卡片 "将'完成文档编写'卡片移动到'进行中'列表" # 添加检查清单 "为'完成文档编写'卡片添加一个检查清单,包括:编写API文档、更新README、添加示例代码" # 分配成员 "将这个任务分配给张三"7. 注意事项
- API令牌安全:令牌具有永不过期的读写权限,请妥善保管
- 默认看板:可设置TRELLO_DEFAULT_BOARD以简化工具调用
- 看板ID获取:在浏览器中打开看板,在URL后添加.json查看,或调用list_boards
- 权限范围:令牌需要read和write权限才能使用所有功能
- 重启客户端:配置后需要重启Claude Code会话才能看到新工具
- MCP Inspector:可使用
uv run fastmcp dev src/trello_mcp/server.py打开检查器进行测试 - 工具数量:服务器提供16个工具,覆盖看板、列表、卡片的完整生命周期
- 本地运行:服务器在本地运行,需要保持Python进程活跃