MCPTrello

一个 MCP（Model Context Protocol）服务器，暴露一组小型、精选的 Trello 工具——目的是让智能体无需手工粘贴上下文即可读取并轻度更新 Trello 看板，同时也是一次关于工具描述如何塑造智能体行为的学习练习（每个工具背后的设计理由见 DESIGN_NOTES.md）。

工具

不在此 v1 范围之内：完整 CRUD、远程/OAuth 认证、访问限流、MCP resources/prompts、cc-init 命令、自动创建清单，以及多次调用之间缓存看板/列表名称。

Related MCP server: trello-mcp-server

设置

1. 获取 Trello 凭据

1. 访问 https://trello.com/power-ups/admin，创建（或选择）一个 Power-Up，获得 API 密钥。

2. 在同一密钥页面，按“Token”链接生成一个 令牌——这会授权该密钥以你的 Trello 账户身份进行操作。

2. 配置环境

cp .env.example .env

填写 .env：

TRELLO_API_KEY=...
TRELLO_TOKEN=...
DEFAULT_BOARD_ID=...   # optional — id of the board to use when `board` is omitted

DEFAULT_BOARD_ID 可选。未设置时，需要看板的工具要么要求你一个显式传入，要么（对于 search_cards）搜索你能访问的所有看板。

3. 安装并构建

需要 Node.js 18+。

npm install
npm run build

4. 注册到 Claude Code

claude mcp add trello -- node <absolute-path-to-repo>\dist\index.js

验证

• npm run build —— TypeScript 构建；在任意源码改动后运行它。

• npm run verify —— 将构建后的服务器作为子启动进程，通过 stdio 启动，并使用 MCP SDK 自带的 Client + StdioClientTransport, 列出所有工具，并针对你的真实 Trello 账户逐一调用每个工具（每个工具都包含至少一个错误/歧义情形）。**要求完全填好 .env`** —— 它会进行真实 API 调用。

• MCP Inspector（npx @modelcontextprotocol/inspector --cli node ../../dist/index.js --method tools/list）是辅助、尽力而为的检查。每个已发布版本的 Inspector 都需要 Node ≥ 22.7.5；在 Node 18 上无法启动。如果你想运行它，请使用单独的 Node 22+ 安装（如 nvm），而不是提高项目的运行时要求。