Trello交互工具集

基于Go语言开发的Trello MCP服务器,提供21种工具用于通过Model Context Protocol与Trello面板、列表、卡片、标签和检查清单进行交互。

  • by Andressc19
  • Go
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Andressc19/mcp-trello

使用说明

mcp trello

Trello的MCP服务器是用Go编写的。提供21个工具,用于通过模型上下文协议与Trello板、列表、卡片、标签和清单进行交互。

先决条件

快速设置(交互式TUI)

配置mcp-trello的最快方法是使用交互式TUI安装程序:

mcp-trello setup

这将启动一个漂亮的终端界面(由 珍珠奶茶)这将:

  1. 指导您完成凭据设置 -使用安全的输入屏蔽输入您的Trello API密钥和令牌
  2. 保存凭据 到 ~/.config/opencode/mcp-trello.json
  3. 自动配置OpenCode --将MCP服务器添加到您的 opencode.json 配置
  4. 验证配置 --检查所有设置是否正确

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"
  }
}

许可证

麻省理工学院