trello-mcp

trello-mcp

使用 Go 编写的本地 Trello MCP 服务。提供 48 个工具、精简响应和访客看板。

一个列表中的 16 张卡片。响应文本字符数，越少越精简。

对于这次调用（摘要模式），响应文本比官方服务少 77%。测量时间为 2026-10-17，使用一个包含 144 张卡片的私人工作看板；统计字符数，而非词元。完整模式：9,112（少 69%）。对于单张卡片的详细信息，官方服务返回的内容更少：2,662 对比 2,825。所有结果和方法。

安装

curl -fsSL https://raw.githubusercontent.com/avhn/trello-mcp/main/install.sh | sh

Windows：irm https://raw.githubusercontent.com/avhn/trello-mcp/main/install.ps1 | iex。安装包会经过校验和验证。

或者将以下内容交给你的 Agent：

Set up trello-mcp by following https://raw.githubusercontent.com/avhn/trello-mcp/main/docs/setup.md; ask me to run its printed absolute-path auth command myself in a private terminal, then reconnect. Never capture authentication output.

然后：在私密终端中自行运行输出的 auth 命令，完成注册并重新连接。 客户端和 Claude Desktop：docs/setup.md。

实测对比

实测响应文本。字符数；各行使用独立的零起点刻度。

工具定义。来自单个会话中 /context 的 Claude 令牌数。未测量 Node。数值越低越小。

单个会话中的 Claude Code /context；超过 1k 的行按 0.1k 精度四舍五入显示。Node 无法载入 /context。此外，tools/list：20,583 vs 33,766 个字符（比 Node 少 39%），不是令牌数。

调用	trello-mcp	Official	Node 1.8.1	比 Official 少	比 Node 少
看板列表，每个返回的看板（字符数/看板）	150	622	8,682	少 76%	少 98%
16 张卡片，摘要（字符数）	6,754	29,141	45,335	少 77%	少 85%
16 张卡片，完整内容（字符数）	9,112	29,141	45,335	少 69%	少 80%
50 项看板操作（字符数）	15,494	55,331	71,008	少 72%	少 78%
一张卡片的详情（字符数）	2,825	2,662	16,350	多 6%	少 83%
该卡片上的评论，2 条评论（字符数）	586	1,089	3,232	少 46%	少 82%
工具定义（Claude 令牌数）	8,107（48 个工具）	19,664（15 个工具）	未测量	少 59%	不适用

一个看板、一天、一个账户。trello-mcp 使用提交 cb40466（v1.0.3）；通过 OAuth 访问 Atlassian 托管的 https://mcp.trello.com/v1，结果直接摘录自无头 Claude Code 会话；@delorenj/mcp-server-trello 1.8.1 通过 npx 运行。看板列表数据是不同数据集（16 / 15 / 29）中每个返回看板的字符数；Node 包含 13 个已关闭的看板；trello-mcp 多出的看板是另一个组织中的访客看板。卡片详情和评论使用同一张卡片及其两条评论。该看板为私有，因此其他人无法使用相同数据重新运行测试。Official 的结果反映了测试当天的托管版本。工具定义是来自 /context 的 Claude 令牌数；按字符数除以 4 计算，trello-mcp 约为 5,146，而不是 8,107。

汇总数据。方法与测试框架。少百分比 = round(100 * (1 - ours/theirs))；每个看板的数值为总数/数量，四舍五入得出。

我经常用 AI 助手处理 Trello，因此构建了 trello-mcp，让它更轻量、更易用。

一点想法：对于 AI Agent，管理上下文可能是我们现在需要进行的主要优化之一。模型读取的每个工具定义和响应都会占用实际任务的空间；随着上下文增大，输出质量往往会下降。

功能核查日期：2026-10-17。

功能	trello-mcp	Official	Node 1.8.1
运行方式	本地二进制文件	托管，OAuth	本地运行，Node 或 Bun
访客看板	是	所有者于 2026-10-16 核查时未找到	是
删除评论	是	否：列出、添加、编辑	是
创建、更新、删除标签	是	否：列出、附加、分离	是
附件	上传并下载到磁盘，需主动启用，Unix	仅列出	可上传任意本地路径，下载时使用内联 base64
按对象设置工作区允许列表	是	每个工作区通过 OAuth 授权	可列出并执行部分工作区操作
服务端只读模式	是	不适用（托管）	未说明

若要免安装使用网页和移动端、收件箱、Planner 或关键词搜索，请选择 Official。

面向读取的配置

十个读取工具（配置位置；board_use 用于设置本地默认看板）：

TRELLO_TOOLS=workspace_find,board_find,board_use,list_find,card_find,card_get,comment_find,checklist_get,checklist_items,server_health

合成参考数据

使用 go test ./internal/bench -update 重新生成的合成测试数据，与相同对象的原始 Trello JSON 对比。

场景	原始 Trello JSON	本服务	缩减比例
20 个看板	~2166	~433	80.0%
列表中的 30 张卡片	~9266	~2968	68.0%
20 条评论	~6739	~4311	36.0%
50 个看板操作	~11910	~4248	64.3%
22 个卡片操作	~4888	~1368	72.0%
含 20 条评论的卡片	~7404	~4465	39.7%

合成的原始格式化 JSON 是可复现的参考数据，并非来自其他 MCP 服务的实测输出。Token 数按字符数 ÷ 4 计算。

启动开销	默认（48 个工具）	面向读取的工具发现（10 个工具）
tools/list	20694 个字符（~5174 个 token）	4400 个字符（~1100 个 token）
初始化指令	140 个字符（~35 个 token）	141 个字符（~35 个 token）
初始化结果（含指令）	304 个字符（~76 个 token）	305 个字符（~76 个 token）

独立响应	字符数	Token 数（字符数 ÷ 4）
card_find 摘要（30 张卡片）	11873	~2968
card_find 完整结果（30 张卡片）	15023	~3756
board_activity 所有操作（50 个操作）	16994	~4248
board_activity commentCard	5835	~1459
board_activity updateCard	5476	~1369

文档

设置 · 配置与安全 · 工具

许可证

GPL-3.0-or-later，版权所有 Mert Dede（截至 v0.5.0 采用 MIT 许可证）。这是 delorenj/mcp-server-trello 1.8.1（MIT）工具接口的独立 Go 实现，不是 运行时依赖。Trello 是 Atlassian 的商标。trello-mcp 是独立项目，与 Atlassian 无关，也未获其认可。