使用说明
项目简介
Trello MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端,旨在将您的 Trello 工作空间连接到支持 MCP 协议的 LLM 客户端。通过此服务器,您可以让 LLM 应用访问和操作 Trello 中的看板、列表和卡片,实现任务管理和工作流程的自动化。
主要功能点
- 资源访问: 将 Trello 看板 (boards)、列表 (lists) 和卡片 (cards) 暴露为 MCP 资源,允许 LLM 客户端以标准化的方式读取 Trello 数据。
- 工具调用: 提供丰富的工具 (tools),使 LLM 客户端能够执行各种 Trello 操作,包括:
- 创建、移动和归档卡片
- 添加评论和标签
- 获取看板和列表信息
- 标准化接口: 遵循 MCP 协议,提供基于 JSON-RPC 的标准化接口,方便 LLM 客户端集成。
安装步骤
- 环境准备: 确保您的计算机上已安装 Node.js 和 npm (或 yarn)。
- 下载仓库: 克隆 GitHub 仓库到本地:
git clone https://github.com/yairhaimo/trello-mcp-server.git cd trello-mcp-server - 安装依赖: 在仓库目录下运行以下命令安装项目依赖:
npm install - 配置环境变量:
- 在仓库根目录下创建 '.env' 文件。
- 在 '.env' 文件中填入您的 Trello API 密钥和 Token:
请访问 https://trello.com/app-key 获取您的 API 密钥,并按照 Trello 官方文档获取 API Token。TRELLO_API_KEY=YOUR_TRELLO_API_KEY TRELLO_API_TOKEN=YOUR_TRELLO_API_TOKEN
- 构建项目: 运行以下命令构建项目:
npm run build
服务器配置
MCP 客户端需要配置以下信息以连接到 Trello MCP Server:
{ "serverName": "Trello-MCP-Server", "command": "node", "args": ["build/index.js"] }
配置参数说明:
- 'serverName': 服务器名称,可以自定义,例如 "Trello-MCP-Server"。
- 'command': 启动服务器的命令,这里使用 'node' 运行 JavaScript 文件。
- 'args': 命令参数,指定要运行的服务器入口文件,这里是 'build/index.js'。
基本使用方法
- 启动 MCP 服务器:在 MCP 客户端中配置上述服务器配置信息,客户端将自动启动 Trello MCP Server。
- 连接服务器:客户端成功启动服务器后,将通过 Stdio 传输协议与服务器建立连接。
- 使用 MCP 功能:通过 MCP 客户端,您可以向 Trello MCP Server 发送 MCP 请求,例如:
- 读取资源: 使用 'mcp:read' 请求读取 Trello 资源,例如获取所有看板列表 'mcp:read trello://boards'。
- 调用工具: 使用 'mcp:tool' 请求调用预定义的工具,例如创建卡片 'mcp:tool create-card' 并附带必要的参数。
请参考 MCP 协议文档和仓库代码中工具的定义,了解可用的资源 URI 和工具参数,以便在 LLM 应用中充分利用 Trello MCP Server 的功能。
信息
分类
生产力应用