使用说明
Trello MCP服务器
令牌优化 模型上下文协议 Trello服务器,专为 克劳德代码.
为什么?
标准的Trello API响应充斥着Claude不需要的元数据。此服务器:
- 仅请求基本字段 来自Trello API(
fields=参数) - 返回精简文本摘要 而不是原始JSON
- 截断描述 保存上下文标记
- 缓存板结构 (列表、标签)以避免重复的API调用
结果: 代币数量减少60-80% 与原始API相比,每个Trello交互。
设置
1.安装依赖项
bun install
2.获取Trello证书
- 获取API密钥:https://trello.com/power-ups/admin
- 从同一页面生成令牌
- 从板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 在:
- 当前工作目录
- 这
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"
许可证
麻省理工学院
