Trello MCP 服务器

Trello MCP 服务器是一个为Trello设计的令牌优化服务器,通过请求仅包含必要字段、返回紧凑文本摘要和缓存板结构来减少60-80%的令牌使用,适用于Claude Code。

  • by DKeken
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 DKeken/trello-mcp

使用说明

Trello MCP服务器

令牌优化 模型上下文协议 Trello服务器,专为 克劳德代码.

为什么?

标准的Trello API响应充斥着Claude不需要的元数据。此服务器:

  • 仅请求基本字段 来自Trello API(fields= 参数)
  • 返回精简文本摘要 而不是原始JSON
  • 截断描述 保存上下文标记
  • 缓存板结构 (列表、标签)以避免重复的API调用

结果: 代币数量减少60-80% 与原始API相比,每个Trello交互。

设置

1.安装依赖项

bun install

2.获取Trello证书

  1. 获取API密钥:https://trello.com/power-ups/admin
  2. 从同一页面生成令牌
  3. 从板URL中查找您的板ID: https://trello.com/b/<BOARD_ID>/...

3.配置环境

export TRELLO_API_KEY="your-api-key"
export TRELLO_TOKEN="your-token"
export TRELLO_BOARD_ID="your-default-board-id"  # optional

服务器还支持本地 .env 当流程环境中不存在这些变量时,进行回退。它寻找 .env 在:

  1. 当前工作目录
  2. 这 trello-mcp-server/ 目录

例子:

TRELLO_API_KEY=your-api-key
TRELLO_TOKEN=your-token
TRELLO_BOARD_ID=your-default-board-id

4.添加到克劳德代码

添加到您的 ~/.claude/settings.json 或项目 .claude/settings.json:

{
  "mcpServers": {
    "trello": {
      "command": "bun",
      "args": ["run", "/path/to/trello-mcp-server/index.ts"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token",
        "TRELLO_BOARD_ID": "your-default-board-id"
      }
    }
  }
}

可用工具

工具 说明
get_active_board_info 电路板概述:列表、标签、卡片计数
get_lists 所有带有ID的板列表
get_cards_by_list_id 特定列表中的卡片
get_all_cards 按列表分组的所有卡片(默认情况下不包括“完成”)
get_card 完整的卡片详细信息,包括清单和注释
add_card_to_list 创建新卡
move_card 将卡移动到其他列表
update_card_details 更新卡片名称、描述、到期日期、标签
archive_card 存档(软删除)卡
add_comment 在卡片上添加评论
read_comments 从带有全文和元数据的卡片中获取所有评论
get_board_labels 板上的所有标签
get_recent_activity 最近的董事会活动
manage_checklist 创建检查表,添加/切换项目
search_cards 按名称、描述或标签搜索卡片

多板支持

所有工具都接受可选 board 参数——板URL、shortLink或全板ID。如果省略, TRELLO_BOARD_ID 使用。

# These all work:
board: "https://trello.com/b/ABC123/my-board"
board: "ABC123"
board: "60d5ecb5a3b2c123456789ab"

许可证

麻省理工学院