trello-mcp MCP 服务说明文档
2026/9/11 17:34:14 网站建设 项目流程

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_id

Claude Code配置:

claude mcp add trello --scope user -- \ uv run --directory "$(pwd)" trello-mcp

5. 接口定义

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进程活跃

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询