Trello MCP Server

Trello MCP Server

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

常见问题解答

  1. 如何获取 Trello API 密钥和令牌? 可以从 Trello 开发者门户 获取。

  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

调试方式

  1. 确保服务器正在运行: bash npm start

  2. 使用提供的工具进行 API 调用,例如: bash curl http://localhost:3000/api/boards

  3. 检查日志以获取错误信息。

许可证

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