内容
trello-mcp
==========
[概述]
本地基于stdio的Trello MCP服务器。Trello API调用直接在用户PC上进行。
[公开分发]
- credential·板ID等识别信息不包含在报告中（token.txt在gitignore中）。
[要求]
- Node.js 20+（Mac / Windows共通）
- Trello API密钥/token
[环境变量]
- TRELLO_API_KEY（必填）
- TRELLO_TOKEN（必填）
- TRELLO_ALLOWED_BOARD_IDS（选填，逗号分隔的允许列表）
- TRELLO_READ_ONLY（选填，true则禁用写入工具）
[MCP联动]
--- Cursor ---
- 配置文件：~/.cursor/mcp.json（Mac）/ %USERPROFILE%\.cursor\mcp.json（Windows）
- 示例：examples/cursor.mcp.json
- 复制examples/cursor.mcp.json中的mcpServers块（仅需设置Trello密钥/token）
--- Claude Code ---
- 配置文件（可选）：
- 项目：{repo}/.mcp.json（团队共享，首次在/mcp中批准）
- 用户全局：~/.claude.json的mcpServers
- 示例：examples/claude-code.mcp.json
- 支持${TRELLO_API_KEY}形式的env扩展 → 建议在shell中导出后使用
- CLI：claude mcp add local-trello --scope user -- npx -y github:telnturtle/trello-mcp
--- Codex (OpenAI) ---
- 配置文件：~/.codex/config.toml（全局）或.codex/config.toml（项目，可信）
- 示例：examples/codex.config.toml
- CLI：codex mcp add local-trello -- npx -y github:telnturtle/trello-mcp
- 在会话中确认连接到/mcp
[共通npx示例]
"command": "npx",
"args": ["-y", "github:telnturtle/trello-mcp"],
"env": {
"TRELLO_API_KEY": "您的API密钥",
"TRELLO_TOKEN": "您的token"
}
[Windows参考]
- 使用npx方式可以在Mac/Windows上进行相同的设置
- Node需要从nodejs.org安装LTS（20+）
[安装 — 在本地路径上运行]
- git clone https://github.com/telnturtle/trello-mcp
- cd trello-mcp && npm install && npm run build
- 参考：.env.example（实际密钥/token不要提交）
- npm install时，prepare脚本会自动执行build
- MCP设置：参考examples/cursor.local-path.mcp.json
[boardId 안내]
- 使用URL短ID以外的API板ID（通过trello_list_boards确认）
[提供的工具]
- 系统：trello_health
- 工作空间：trello_list_workspaces, trello_list_workspace_boards
- 板/列表/卡片查询：trello_list_boards, trello_list_lists,
trello_list_board_members, trello_list_cards_by_list, trello_search_cards,
trello_get_card
- 标签查询：trello_list_board_labels
- 评论查询：trello_list_card_comments
- 写入：trello_create_card, trello_attach_url_to_card, trello_add_comment,
trello_update_comment, trello_delete_comment, trello_assign_member,
trello_remove_member, trello_move_card, trello_update_card,
trello_create_label, trello_update_label, trello_delete_label,
trello_set_card_labels, trello_archive_card
（需要confirm：true，READ_ONLY=true时禁用）
[安全]
- 密钥/token仅通过环境变量注入，禁止提交到代码/报告中
- 可以通过允许列表限制板访问
- 在搜索/详细响应中，描述和评论默认排除或仅在选项中包含
- 日志中不记录认证信息·卡片正文·评论原文
[本地测试脚本]
- 共通：需要TRELLO_API_KEY，TRELLO_TOKEN
- 可选：TRELLO_TEST_BOARD_ID（指定板测试）
- scripts/test-readonly.mjs（只读）
- scripts/test-mcp-readonly.mjs（MCP stdio只读）
- scripts/test-write-workflow.mjs（写入综合，列表·成员ID等环境变量指定目标）
[脚本]
- npm run build — 将TypeScript编译到dist/
- npm run prepare — npm install时自动执行（build）
- npm run dev — 使用tsx进行开发执行
- npm start — 执行dist/index.js
[examples/]
- cursor.mcp.json — Cursor npx联动
- cursor.local-path.mcp.json — Cursor本地节点路径
- claude-code.mcp.json — Claude Code .mcp.json
- codex.config.toml — Codex config.toml
