返回 MCP 目录
public公开dns本地运行

trello-mcp-server

Trello MCP服务器是一个基于Model Context Protocol的服务器,提供与Trello API交互的工具,包含完整的Trello功能接口、模块化架构和类型安全支持。

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 服务器,可按以下步骤操作:

  1. 克隆仓库:
    git clone https://github.com/v4lheru/trello-mcp-server.git
    cd trello-mcp-server
    
  2. 安装依赖项:
    npm install
    
  3. 启动服务器:
    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 服务器做出贡献,请按照以下步骤操作:

  1. 克隆仓库:
    git clone https://github.com/v4lheru/trello-mcp-server.git
    cd trello-mcp-server
    
  2. 创建功能分支:
    git checkout -b feature/<your-feature>
    
  3. 提交更改:
    git add .
    git commit -m "Add new feature"
    
  4. 推送到远程仓库并创建拉取请求。

📄 许可证

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

📞 联系方式

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

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端