Trello MCP Server

Trello MCP 服务

一个模型上下文协议（MCP）服务，提供用于与 Trello API 交互的工具。

凭据安全地存储在操作系统凭据管理器中，而非明文文件。

功能

• 安全凭据存储：凭据存储在操作系统凭据管理器中（Windows Credential Manager、macOS Keychain 或 Linux libsecret）
• 无明文密钥：不使用 .env 文件，也不使用环境变量存储凭据
• Trello 集成：完整访问 Trello 看板、列表、卡片等内容
• 全面的 API 覆盖：支持所有主要的 Trello 操作
• 类型安全：全面支持 TypeScript，并为 Trello 对象提供适当的类型定义
• 错误处理：在整个代码库中提供稳健的错误管理

入门指南

先决条件

• Node.js 18 或更高版本
• npm
• Trello API 密钥和令牌（见下文）

仅限 Linux：安装 libsecret

# Debian/Ubuntu
sudo apt install libsecret-1-dev

# Fedora
sudo dnf install libsecret-devel

# Arch
sudo pacman -S libsecret

安装

1. 克隆此仓库：

   git clone https://github.com/v4lheru/trello-mcp-server.git
   cd trello-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 安全设置凭据：

   npm run setup-credentials
   

   系统会提示你输入 Trello API 密钥和令牌，然后将其存储在操作系统凭据管理器中。

   获取凭据的方法：

   1. 前往 https://trello.com/app-key
   2. 复制你的 API 密钥
   3. 点击“Generate a Token”并复制令牌

使用方法

启动 MCP 服务：

npm start

从 .env 文件迁移

如果你已有的凭据存储在 .env 文件中，设置脚本会自动检测：

npm run setup-credentials

你会看到：

📁 Found existing credentials in: /path/to/.env
   Both API Key and Token found.

Migrate these credentials to secure storage? (Y/n):

迁移后，你可以选择从 .env 文件中删除凭据。

管理凭据

• 设置/更新凭据：npm run setup-credentials
• 删除凭据：npm run delete-credentials

凭据存储位置：

• Windows：Credential Manager → Windows Credentials → trello-mcp-server
• macOS：Keychain Access → trello-mcp-server
• Linux：GNOME Keyring / KDE Wallet → trello-mcp-server

Claude Desktop 配置

将以下内容添加到 Claude Desktop 配置文件（claude_desktop_config.json）中：

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["C:/path/to/trello-mcp-server/build/index.js"]
    }
  }
}

可用工具

看板工具

• 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 - 将列表中的所有卡片移动到另一个列表

卡片工具

• get_card - 根据 ID 获取特定卡片
• create_card - 创建新卡片
• update_card - 更新现有卡片
• delete_card - 删除卡片
• archive_card - 归档卡片
• move_card_to_list - 将卡片移动到其他列表
• add_comment - 为卡片添加评论
• get_comments - 获取卡片上的评论
• add_attachment - 为卡片添加附件
• get_attachments - 获取卡片上的附件
• set_due_date - 设置卡片的截止日期
• set_due_complete - 将卡片的截止日期标记为已完成

成员工具

• get_me - 获取已认证成员（当前用户）
• get_member - 根据 ID 或用户名获取特定成员
• get_member_boards - 获取成员所属的看板
• get_member_cards - 获取分配给成员的卡片
• search_members - 按姓名搜索成员

标签工具

• get_label - 根据 ID 获取指定标签
• create_label - 在看板上创建新标签
• update_label - 更新现有标签
• delete_label - 删除标签
• add_label_to_card - 将标签添加到卡片
• remove_label_from_card - 从卡片移除标签

清单工具

• get_checklist - 根据 ID 获取指定清单
• create_checklist - 在卡片上创建新清单
• update_checklist - 更新现有清单
• delete_checklist - 删除清单
• get_checkitems - 获取清单中的所有检查项
• create_checkitem - 在清单中创建新检查项
• update_checkitem - 更新清单中的检查项
• delete_checkitem - 从清单中删除检查项

安全性

凭据存储在操作系统的凭据管理器（Windows Credential Manager、macOS Keychain 或 Linux libsecret）中，并使用您的登录凭据加密。

许可证

本项目采用 MIT License 许可。