推罗 MCP 服务器

Name: 推罗 MCP 服务器
Author: lioarce01

作者：lioarce015 星标更新：2025-05-30

安装使用来源：spider==github.com

项目介绍

Trello MCP Server

一个模型上下文协议（MCP）服务器，用于连接Trello与AI助手如Claude Desktop、GitHub Copilot Chat和其他兼容MCP的客户端。

功能

📋 列出所有Trello看板
🔍 阅读看板内容（列表和卡片）
➕ 创建新卡片
🔄 在列表之间移动卡片
💬 向卡片添加评论
🗃️ 归档卡片
🔗 将看板作为MCP资源访问
🐳 支持Docker以方便部署

先决条件

安装Node.js 20+（用于本地开发）
Docker（用于容器化部署）
一个Trello账户
Trello API凭证（API密钥和令牌）

安装

方案1：本地安装

克隆此仓库：

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

安装依赖：

npm install

构建TypeScript代码：

npm run build

方案2：Docker安装

克隆此仓库：

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

构建Docker镜像：

docker build -t trello-m
cp-server .

获取Trello API凭证

获取您的API密钥：
- 访问 https://trello.com/app-key
- 复制您的API密钥
获取您的令牌：
- 在同一页面上，点击“令牌”链接
- 授权应用程序并复制您的令牌

配置

对于Claude Desktop

本地安装

在您的Claude Desktop配置文件中添加服务器配置：

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json

{
  "mcp": {
    "servers": {
      "trello-mcp": {
        "command": "node",
        "args": ["绝对路径到项目的dist/index.js"],
        "env": {
          "TRELLO_API_KEY": "您的API密钥",
          "TRELLO_TOKEN": "您的令牌",
          "TRELLO_BASE_URL": "https://api.trello.com/1"
        }
      }
    }
  }
}

Docker配置

对于Docker部署，添加以下配置：

{
  "mcp": {
    "servers": {
      "trello-mcp": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "-i",
          "-e",
          "TRELLO_API_KEY=您的API密钥",
          "-e",
          "TRELLO_TOKEN=您的令牌",
          "-e",
          "TRELLO_BASE_URL=https://api.trello.com/1",
          "trello-mcp-server"
        ]
      }
    }
  }
}

对于VS Code与GitHub Copilot Chat

本地安装

在您的VS Code settings.json中添加：

{
  "mcp": {
    "servers": {
      "trello-mcp": {
        "command": "node",
        "args": ["绝对路径到项目的dist/index.js"],
        "env": {
          "TRELLO_API_KEY": "您的API密钥",
          "TRELLO_TOKEN": "您的令牌",
          "TRELLO_BASE_URL": "https://api.trello.com/1"
        }
      }
    }
  }
}

Docker配置

{
  "mcp": {
    "servers": {
      "trello-mcp": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "-i",
          "-e",
          "TRELLO_API_KEY=您的API密钥",
          "-e",
          "TRELLO_TOKEN=您的令牌",
          "-e",
          "TRELLO_BASE_URL=https://api.trello.com/1",
          "trello-mcp-server"
        ]
      }
    }
  }
}

重要提示：

将绝对路径到项目的dist/index.js替换为您实际编译后的服务器文件的绝对路径（本地安装）
将YOUR_TRELLO_API_KEY和YOUR_TRELLO_TOKEN替换为您实际的Trello凭证

Docker使用

使用Docker Run

# 构建镜像
docker build -t trello-mcp-server .

# 使用API密钥和令牌作为参数运行
docker run --rm -i --env-file .env trello-mcp-server

本地测试

要测试服务器是否正常工作：

构建项目：

npm run build

使用凭证运行：

node dist/index.js

Docker测试

使用Docker构建并运行：

docker build -t trello-mcp-server .
docker run --rm -i --env-file .env trello-mcp-server

您应该看到：

MCP服务器已连接并准备好。

注意： 服务器会等待MCP客户端连接。要退出，请按Ctrl+C。

一旦配置完成，您可以通过自然语言与您的Trello看板进行交互：

列出看板

显示我所有的Trello看板

阅读看板内容

我的“项目管理”看板里有哪些卡片？

创建卡片

在“To Do”列表中创建一张名为“审查文档”的新卡片

移动卡片

将“修复错误”卡片移到“In Progress”列表

添加评论

向卡片添加评论：“这需要紧急处理”

归档卡片

归档已完成的卡片“设置数据库”

可用工具

工具	描述	参数
`list_boards`	列出所有开放的Trello看板	无
`read_board`	从特定看板读取列表和卡片	`boardId`
`create_list`	创建一个列表	`boardId`, `name`
`create_card`	在特定列表中创建一张新卡片	`listId`, `name`, `desc` (可选)
`move_card`	将卡片移动到不同的列表	`cardId`, `listId`
`add_comment`	向卡片添加评论	`cardId`, `text`
`archive_card`	归档一张卡片	`cardId`
`archive_list`	归档一个列表	`listId`
`delete_board`	删除一个看板	`boardId`
`update_list_name`	更新一个列表名称	`listId`, `name`
`update_card_name`	更新一张卡片名称	`cardId`, `name`

可用资源

该服务器公开您的Trello看板作为MCP资源，可以被AI助手读取：

资源URI: board:{boardId}
内容: 包含看板所有列表和卡片的JSON

开发

构建

本地开发

npm run build

Docker开发

# 构建Docker镜像
docker build -t trello-mcp-server .

运行开发

本地开发

为了直接运行服务器（用于测试）：

# 使用npm
npm run build
node dist/index.js

# 使用pnpm
pnpm run build
node dist/index.js

Docker开发

# 使用docker运行（传递凭证作为参数）
docker run --rm -i --env-file .env trello-mcp-server

开发脚本

您还可以在package.json中创建一个开发脚本：

{
  "scripts": {
    "build": "tsc",
    "start": "node dist/index.js",
    "dev": "tsx ./src/index.ts",
    "docker:build": "docker build -t trello-mcp-server .",
    "docker:run": "docker run --rm -i --env-file .env trello-mcp-server"
  }
}

故障排除

服务器未连接

检查凭证： 确保您传递了API密钥和令牌作为参数
验证文件路径： 确保MCP配置中的路径正确（本地安装）
先构建： 测试前始终运行npm run build或docker build
独立测试： 尝试先独立运行服务器
重启客户端： 在更改配置后重启您的MCP客户端（Claude Desktop/VS Code）

Docker特定问题

镜像未找到： 确保您已经使用docker build -t trello-mcp-server .构建了Docker镜像
参数未传递： 确保在镜像名之后传递了API密钥和令牌
权限： 检查Docker是否有运行容器所需的权限

无效凭证错误

再次检查您的Trello API密钥和令牌
确保令牌具有必要的权限
如果令牌过期，请尝试重新生成
验证凭证是否正确传递作为参数

工具无法工作

验证看板/卡片/列表ID是否正确
检查您是否有写入Trello看板的权限
查看控制台日志以获取详细的错误消息

安全注意事项

永远不要将API凭证提交到版本控制系统
安全存储凭证并定期轮换
使用.env文件并将它们添加到.gitignore
服务器仅需要您通过Trello令牌授予的权限
考虑在生产环境中使用环境变量来存储凭证
Docker容器使用非root用户运行以确保安全

许可证

本项目根据MIT许可证发布 - 详情见LICENSE文件。

由❤️为MCP社区制作