
Trello MCP Server

2025.03.13
8
TypeScriptTrello 集成项目管理自动化工具交流协作
Trello MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,专门用于与 Trello API 进行交互。它提供了对 Trello 看板、列表、卡片、成员、标签和检查清单等资源的全面访问,支持所有主要的 Trello 操作。该服务采用模块化架构,具有清晰的职责分离,并支持 TypeScript 类型安全。
View on GitHub
Overview
基本能力
产品定位
Trello MCP Server 是一个专门用于与 Trello API 交互的 MCP 服务,旨在为开发者提供一套完整的工具集,以便于管理和操作 Trello 中的各种资源。
核心功能
- Trello 集成:完全访问 Trello 的看板、列表、卡片等资源
- 全面的 API 覆盖:支持所有主要的 Trello 操作
- 模块化架构:清晰的职责分离和良好的结构定义
- 类型安全:完整的 TypeScript 支持,为 Trello 对象提供正确的类型定义
- 错误处理:在整个代码库中实现健壮的错误管理
适用场景
- 自动化 Trello 看板管理
- 批量操作 Trello 卡片和列表
- 集成 Trello 到其他系统或工作流
- 开发 Trello 相关的自动化工具
工具列表
看板工具
get_boards
- 获取认证用户的所有看板get_board
- 通过 ID 获取特定看板create_board
- 创建新看板update_board
- 更新现有看板delete_board
- 删除看板get_board_lists
- 获取看板上的所有列表get_board_members
- 获取看板的所有成员get_board_labels
- 获取看板上的所有标签close_board
- 关闭(归档)看板reopen_board
- 重新打开已关闭的看板
列表工具
get_list
- 通过 ID 获取特定列表create_list
- 在看板上创建新列表update_list
- 更新现有列表archive_list
- 归档列表unarchive_list
- 取消归档列表move_list_to_board
- 将列表移动到不同看板get_cards_in_list
- 获取列表中的所有卡片archive_all_cards
- 归档列表中的所有卡片move_all_cards
- 将列表中的所有卡片移动到另一个列表update_list_position
- 更新列表在看板上的位置update_list_name
- 更新列表名称subscribe_to_list
- 订阅列表
卡片工具
get_card
- 通过 ID 获取特定卡片create_card
- 创建新卡片update_card
- 更新现有卡片delete_card
- 删除卡片archive_card
- 归档卡片unarchive_card
- 取消归档卡片move_card_to_list
- 将卡片移动到不同列表add_comment
- 向卡片添加评论get_comments
- 获取卡片上的评论add_attachment
- 向卡片添加附件get_attachments
- 获取卡片上的附件delete_attachment
- 从卡片删除附件add_member
- 向卡片添加成员remove_member
- 从卡片移除成员add_label
- 向卡片添加标签remove_label
- 从卡片移除标签set_due_date
- 设置卡片的截止日期set_due_complete
- 标记卡片的截止日期为完成或未完成
成员工具
get_me
- 获取认证成员(当前用户)get_member
- 通过 ID 或用户名获取特定成员get_member_boards
- 获取成员所属的看板get_member_cards
- 获取分配给成员的卡片get_boards_invited
- 获取成员被邀请的看板get_member_organizations
- 获取成员所属的组织get_notifications
- 获取认证成员的通知update_me
- 更新认证成员的信息get_avatar
- 获取认证成员的头像search_members
- 按名称搜索成员get_board_members
- 获取看板的成员get_organization_members
- 获取组织的成员get_card_members
- 获取卡片上分配的成员
标签工具
get_label
- 通过 ID 获取特定标签create_label
- 在看板上创建新标签update_label
- 更新现有标签delete_label
- 删除标签get_board_labels
- 获取看板上的所有标签update_label_name
- 更新标签名称update_label_color
- 更新标签颜色create_label_on_card
- 直接在卡片上创建新标签get_card_labels
- 获取卡片上的所有标签add_label_to_card
- 向卡片添加标签remove_label_from_card
- 从卡片移除标签
检查清单工具
get_checklist
- 通过 ID 获取特定检查清单create_checklist
- 在卡片上创建新检查清单update_checklist
- 更新现有检查清单delete_checklist
- 删除检查清单get_checkitems
- 获取检查清单上的所有检查项create_checkitem
- 在检查清单上创建新检查项get_checkitem
- 获取检查清单上的特定检查项update_checkitem
- 更新检查清单上的检查项delete_checkitem
- 从检查清单删除检查项update_checklist_name
- 更新检查清单名称update_checklist_position
- 更新检查清单在卡片上的位置get_checklist_board
- 获取检查清单所在的看板get_checklist_card
- 获取检查清单所在的卡片update_checkitem_state_on_card
- 更新卡片上检查项的状态
常见问题解答
-
如何获取 Trello API 密钥和令牌? 可以从 Trello 开发者门户 获取。
-
如何配置环境变量? 复制
.env.example
文件为.env
并填写您的 Trello API 密钥和令牌。 -
如何运行服务器? 使用
npm start
命令运行服务器。
使用教程
使用依赖
- Node.js 18 或更高版本
- npm 或 yarn
- Trello API 密钥和令牌
安装教程
-
克隆仓库:
bash git clone https://github.com/yourusername/trello-mcp-server.git cd trello-mcp-server
-
安装依赖:
bash npm install
-
创建
.env
文件:bash cp .env.example .env
-
编辑
.env
文件,填写您的 Trello API 密钥和令牌:TRELLO_API_KEY=your_trello_api_key TRELLO_TOKEN=your_trello_token
构建和运行
-
构建项目:
bash npm run build
-
运行服务器:
bash npm start
调试方式
-
确保服务器正在运行:
bash npm start
-
使用提供的工具进行 API 调用,例如:
bash curl http://localhost:3000/api/boards
-
检查日志以获取错误信息。