trello-mcp-server

Trello MCP 服务器

模型上下文协议 (MCP) 服务器，提供与 Trello API 交互的工具。基于通用 MCP 服务器模板构建。

特征

• Trello 集成：完全访问 Trello 板、列表、卡片等
• 全面的 API 覆盖：支持所有主要的 Trello 操作
• 模块化架构：通过定义明确的结构明确地分离关注点
• 类型安全：完全支持 TypeScript，并为 Trello 对象提供正确的类型
• 错误处理：整个代码库的强大错误管理

项目结构

入门

先决条件

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

安装

1. 克隆此存储库：
   git clone https://github.com/yourusername/trello-mcp-server.git cd trello-mcp-server
2. 安装依赖项：
   npm install
3. 根据.env.example创建.env文件：
   cp .env.example .env
4. 使用您的 Trello API 密钥和令牌编辑.env文件：
   TRELLO_API_KEY=your_trello_api_key TRELLO_TOKEN=your_trello_token
   您可以从Trello 开发者门户获取这些。

构建和运行

1. 构建项目：
   npm run build
2. 运行服务器：
   npm start

可用工具

该服务器提供与所有主要 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 - 更新卡片上的检查项状态

配置

服务器使用src/config.ts中的集中式配置系统。可以通过以下方式提供配置：

• 环境变量
• 命令行参数（使用--env KEY=VALUE ）
• 代码中的默认值

所需的环境变量：

• TRELLO_API_KEY - 您的 Trello API 密钥
• TRELLO_TOKEN - 您的 Trello API 令牌

错误处理

该服务器包括全面的错误处理：

• 具有速率限制支持的服务级错误处理
• 使用适当的错误消息进行工具级错误处理
• MCP 协议错误处理
• Trello API 错误处理

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。