使用说明
mcp trello
Trello的MCP服务器是用Go编写的。提供21个工具,用于通过模型上下文协议与Trello板、列表、卡片、标签和清单进行交互。
先决条件
- 转到1.25+
- Trello API密钥+令牌(在这里买你的)
快速设置(交互式TUI)
配置mcp-trello的最快方法是使用交互式TUI安装程序:
mcp-trello setup
这将启动一个漂亮的终端界面(由 珍珠奶茶)这将:
- 指导您完成凭据设置 -使用安全的输入屏蔽输入您的Trello API密钥和令牌
- 保存凭据 到
~/.config/opencode/mcp-trello.json - 自动配置OpenCode --将MCP服务器添加到您的
opencode.json配置 - 验证配置 --检查所有设置是否正确
TUI功能
- 键盘导航:使用箭头键(
↑/↓)或j/k为了导航,Enter选择 - 输入屏蔽:为了安全起见,API密钥和令牌被自动屏蔽
- 浏览器集成:新闻
o在浏览器中打开Trello的管理页面 - 返回导航:新闻
b返回上一步 - 验证配置:从主菜单检查当前配置
- 卸载选项:完全删除凭据和OpenCode配置
手动安装
go install github.com/Andressc19/mcp-trello@latest
二进制文件将安装到 $GOPATH/bin/mcp-trello.确保 $GOPATH/bin 在你的 PATH.
配置
选项1:交互式设置(推荐)
mcp-trello setup
选项2:配置文件
在以下位置创建配置文件 ~/.config/opencode/mcp-trello.json:
{
"apiKey": "your_trello_api_key",
"token": "your_trello_token"
}
选项3:环境变量
export TRELLO_API_KEY=your_api_key
export TRELLO_TOKEN=your_token
优先:环境变量>配置文件
OpenCode集成
添加到您的 ~/.config/opencode/opencode.json:
{
"mcp": {
"trello": {
"command": ["mcp-trello"],
"enabled": true,
"type": "local"
}
}
}
或者让TUI安装程序自动完成 mcp-trello setup.
发展
依赖项
对于TUI开发,需要以下依赖关系:
这些包括在 go.mod 并且将在构建时自动获取。
构建
go build -o mcp-trello .
运行测试
go test ./...
工具
董事会(3)
| 工具 | 说明 |
|---|---|
list_boards |
列出用户有权访问的所有板 |
get_board |
获取特定电路板的信息 |
get_board_labels |
从板上获取所有标签 |
列表(4)
| 工具 | 说明 |
|---|---|
get_lists |
从公告板获取所有列表 |
create_list |
在板上创建新列表 |
update_list |
更新列表(重命名) |
archive_list |
存档列表 |
卡片(7)
| 工具 | 说明 |
|---|---|
get_cards_by_list_id |
从特定列表中获取所有卡片 |
get_card |
获取特定卡的详细信息 |
add_card_to_list |
向列表中添加新卡 |
update_card |
更新卡详细信息 |
move_card |
将卡片移动到另一个列表 |
archive_card |
将卡片存档 |
delete_card |
永久删除卡片 |
标签(3)
| 工具 | 说明 |
|---|---|
create_label |
在电路板上创建新标签 |
add_label_to_card |
为卡片添加标签 |
remove_label_from_card |
从卡片上移除标签 |
检查表(4)
| 工具 | 说明 |
|---|---|
create_checklist |
在卡片上创建新的检查表 |
add_checklist_item |
将项目添加到检查表中 |
complete_checkitem |
将清单项目标记为已完成 |
uncomplete_checkitem |
将清单项目标记为不完整 |
总计:21个工具
使用示例
列出您的所有董事会
{
"tool": "list_boards"
}
在板上创建新列表
{
"tool": "create_list",
"arguments": {
"boardId": "60a7f5e3b9c8d1234567890a",
"name": "My New List"
}
}
将卡片添加到列表中
{
"tool": "add_card_to_list",
"arguments": {
"listId": "60a7f5e3b9c8d1234567890b",
"name": "New Task",
"description": "This is a new task",
"dueDate": "2024-12-31T23:59:59Z",
"labels": ["60a7f5e3b9c8d1234567890c"]
}
}
将卡片移动到另一个列表
{
"tool": "move_card",
"arguments": {
"cardId": "60a7f5e3b9c8d1234567890d",
"listId": "60a7f5e3b9c8d1234567890e"
}
}
在卡片上创建检查表
{
"tool": "create_checklist",
"arguments": {
"cardId": "60a7f5e3b9c8d1234567890d",
"name": "To Do Items"
}
}