Trello MCP Server

基本能力

产品定位

Trello MCP Server 是一个专门用于与 Trello API 交互的 MCP 服务，旨在为开发者提供高效、安全的 Trello 操作接口。

核心功能

• Trello 集成：全面访问 Trello 看板、列表、卡片等核心功能
• 全面的 API 覆盖：支持所有主要的 Trello 操作
• 模块化架构：清晰的职责分离和良好的结构定义
• 类型安全：完整的 TypeScript 支持，为 Trello 对象提供正确的类型定义
• 错误处理：在整个代码库中实现健壮的错误管理

适用场景

• 需要与 Trello 进行集成的应用程序开发
• 自动化 Trello 看板、列表、卡片等操作的工作流
• 构建基于 Trello 的项目管理工具或插件

工具列表

Board Tools

• get_boards - 获取认证用户的所有看板
• get_board - 通过 ID 获取特定看板
• create_board - 创建新看板
• update_board - 更新现有看板
• delete_board - 删除看板
• get_board_lists - 获取看板上的所有列表
• get_board_members - 获取看板的所有成员
• get_board_labels - 获取看板上的所有标签
• close_board - 关闭（归档）看板
• reopen_board - 重新打开已关闭的看板

List Tools

• 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 - 订阅列表

Card Tools

• 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 - 标记卡片的截止日期为完成或未完成

Member Tools

• 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 - 获取分配给卡片的成员

Label Tools

• 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 - 从卡片中移除标签

Checklist Tools

• 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 - 更新卡片上检查项的状态

常见问题解答

1. 如何获取 Trello API 密钥和令牌？ 可以从 Trello Developer Portal 获取。

2. 如何配置环境变量？ 复制 .env.example 文件为 .env 并填写您的 Trello API 密钥和令牌。

3. 如何运行服务器？ 使用 npm start 命令运行服务器。

使用教程

使用依赖

• Node.js 18 或更高版本
• npm 或 yarn
• Trello API 密钥和令牌

安装教程

1. 克隆仓库： bash git clone https://github.com/yourusername/trello-mcp-server.git cd trello-mcp-server

2. 安装依赖： bash npm install

3. 创建 .env 文件： bash cp .env.example .env

4. 编辑 .env 文件，填写您的 Trello API 密钥和令牌： TRELLO_API_KEY=your_trello_api_key TRELLO_TOKEN=your_trello_token

调试方式

1. 构建项目： bash npm run build

2. 运行服务器： bash npm start

3. 检查服务器是否正常运行，可以通过访问 API 端点进行验证。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。