delorenj/mcp-server-trello

A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards.

MCP Server Trello – AI‑friendly Trello bridge

What it is – 一个微型的、由 Bun 驱动的服务器，实现了 Model Context Protocol (MCP)。它封装了 Trello REST API 并提供了 57 个具备类型的工具（例如：get_card, add_checklist_item, watch_card），AI agent 可以像调用原生函数一样调用它们。该服务器处理身份验证、速率限制、输入验证，并以 JSON 或即插即用的 markdown 格式返回数据。

Why it matters – 许多 AI agent 框架（Claude Desktop, Cursor 等）需要一种可靠的方式来读/写团队的项目看板。该服务器让 agent 在 无需编写自定义 HTTP 代码 的情况下获得看板的 full 访问权限，并添加了更高层级的助手，例如：

Acceptance‑criteria extraction (get_acceptance_criteria) 可以自动查找正确的清单（AC, DoD 等）并报告完成百分比。
Watch tools (watch_card, watch_list) 将 Trello 活动推送到 agent 的通知流中。
Dynamic board/workspace switching 使得同一个服务器可以为多个项目提供服务，而无需重启。

Key features

对 cards, lists, boards, checklists, comments, attachments, labels, custom fields 进行完整的 CRUD 操作。
内置速率限制处理（每个 API key 每 10 秒 300 次请求，每个 token 每 10 秒 100 次请求）。
类型安全的 TypeScript 实现 – agent 会获得正确的参数 schema。
可选的环境变量沙盒化 (TRELLO_ALLOWED_WORKSPACES) 用于多租户安全性。
卡片数据的 Markdown 导出，以便于人类阅读的上下文。
以单个 npm package (@delorenj/mcp-server-trello) 分发，可以使用 bunx 或 npx 启动。

How to get it running

Install – npm i -g @delorenj/mcp-server-trello（或者直接在你的 MCP client 中引用该包；无需克隆）。
Configure – 创建一个 .env 文件，包含 TRELLO_API_KEY 和 TRELLO_TOKEN（可从 https://trello.com/app-key 获取）。可选变量允许你设置默认看板、工作区、代理或限制允许的工作区。

Add to an MCP client – 例如在 Claude Desktop 的 mcpServers 配置中：

{
  "trello": {
    "command": "bunx",
    "args": ["@delorenj/mcp-server-trello"],
    "env": {"TRELLO_API_KEY": "…", "TRELLO_TOKEN": "…"}
  }
}

Start – bunx @delorenj/mcp-server-trello（或 npx …）。服务器会向 MCP registry 注册，因此任何感知 registry 的客户端都可以自动发现它。
Use the tools – Agent 通过 README 中显示的 JSON 负载调用暴露的工具（例如：{ "name": "get_card", "arguments": { "cardId": "abc123" } }）。响应包括丰富的数据结构，并且在请求时提供 markdown 渲染。

Skill package – 该仓库还附带了一个兼容 BMAD 的 skill 目录。安装该 skill 会使服务器的工具出现在 agent 的技能集中，并且提供的 install.sh 脚本会在存在 Bun 的情况下在本地构建服务器。

Typical workflow

1. list_boards → pick a board ID
2. set_active_board (or set_active_workspace)
3. get_card / get_checklist_items / get_acceptance_criteria
4. update_checklist_item / move_card / add_comment …
5. watch_card to get live updates

Who should use it – 需要读取或修改 Trello 看板的 AI 助手构建团队（项目管理机器人、冲刺规划 agent、自动化回顾）以及任何想要使用具备类型的、速率限制的、符合 MCP 标准的接口而不是原始 HTTP 调用的人。

Links

npm: https://www.npmjs.com/package/@delorenj/mcp-server-trello
MCP Registry entry: https://registry.modelcontextprotocol.io/servers/io.github.delorenj/mcp-server-trello
Demo badge: https://glama.ai/mcp/servers/klqkamy7wt

delorenj/mcp-server-trello

MCP Server Trello – AI‑friendly Trello bridge

相关