JinDaGe - trello-mcp-server MCP Details

article

README

🚀 Trello MCP 服务器

Trello MCP 服务器是基于 MCP 协议的 Trello 服务端实现，借助该服务器，用户可通过命令行或其他工具与 Trello 进行交互，实现看板、列表、卡片等的管理操作。

🚀 快速开始

Trello MCP 服务器让你可以通过命令行或其他工具与 Trello 进行交互。下面为你展示如何快速开启使用之旅：

# 克隆仓库
git clone https://github.com/v4lheru/trello-mcp-server.git
cd trello-mcp-server

# 安装依赖项
npm install

# 启动服务器
node index.js

✨ 主要特性

协议支持：基于 MCP（Multi-Command Protocol）协议，该协议用于自动化和脚本驱动，可通过命令行与 Trello 交互。
功能丰富：支持创建、读取、更新和删除看板、列表、卡片，还能处理评论、附件等相关功能。
命令多样：提供了丰富的命令集，涵盖看板、列表、卡片、评论等多个方面的操作。

📦 安装指南

要安装 Trello MCP 服务器，可按以下步骤操作：

克隆仓库：

git clone https://github.com/v4lheru/trello-mcp-server.git
cd trello-mcp-server

安装依赖项：
```
npm install
```
启动服务器：
```
node index.js
```

📚 详细文档

配置

Trello MCP 服务器使用配置文件 config.json 进行设置，默认配置如下：

{
  "port": 3000,
  "host": "localhost",
  "api_key": "",
  "token": ""
}

要配置服务器，请在启动前编辑 config.json 文件。

命令

Trello MCP 服务器支持以下命令：

看板相关命令

board create <name>：创建一个新的看板。
board list：列出所有看板。
board delete <id>：删除指定的看板。
board info <id>：获取指定看板的信息。

列表相关命令

list create <board_id> <name>：在指定看板上创建新的列表。
list list <board_id>：列出指定看板上的所有列表。
list delete <board_id> <list_id>：删除指定看板上的指定列表。

卡片相关命令

card create <board_id> <list_id> <name>：在指定列表上创建新的卡片。
card list <board_id> <list_id>：列出指定列表上的所有卡片。
card delete <card_id>：删除指定的卡片。

评论相关命令

comment add <card_id> <text>：向指定卡片添加评论。
comment list <card_id>：列出指定卡片的所有评论。

💻 使用示例

基础用法

以下是一个使用 Trello MCP 服务器的示例：

# 创建一个新的看板
board create "My Project"

# 在新看板上创建一个列表
list create <new_board_id> "To Do"

# 在 "To Do" 列表上创建一张卡片
card create <new_board_id> <to_do_list_id> "Complete Setup"

# 添加一条评论到指定卡片
comment add <card_id> "Great, let's start working!"

🔧 技术细节

Trello MCP 服务器的代码结构如下：

trello-mcp-server/
├── index.js          # 主程序入口
├── config.json       # 配置文件
└── commands/         # 命令处理模块
    ├── board.js     # 看板相关命令处理
    ├── list.js      # 列表相关命令处理
    └── card.js      # 卡片相关命令处理

🤝 贡献指南

如果您希望为 Trello MCP 服务器做出贡献，请按照以下步骤操作：

克隆仓库：

git clone https://github.com/v4lheru/trello-mcp-server.git
cd trello-mcp-server

创建功能分支：
```
git checkout -b feature/<your-feature>
```

提交更改：

git add .
git commit -m "Add new feature"

推送到远程仓库并创建拉取请求。

📄 许可证

Trello MCP 服务器由 MIT 许可证授权。

📞 联系方式

如有任何问题或建议，请联系 Vlad Herus。

trello-mcp-server