使用说明

项目简介

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 客户端集成。

安装步骤

  1. 环境准备: 确保您的计算机上已安装 Node.js 和 npm (或 yarn)。
  2. 下载仓库: 克隆 GitHub 仓库到本地:
    git clone https://github.com/yairhaimo/trello-mcp-server.git
    cd trello-mcp-server
  3. 安装依赖: 在仓库目录下运行以下命令安装项目依赖:
    npm install
  4. 配置环境变量:
    • 在仓库根目录下创建 '.env' 文件。
    • 在 '.env' 文件中填入您的 Trello API 密钥和 Token:
      TRELLO_API_KEY=YOUR_TRELLO_API_KEY
      TRELLO_API_TOKEN=YOUR_TRELLO_API_TOKEN
      请访问 https://trello.com/app-key 获取您的 API 密钥,并按照 Trello 官方文档获取 API Token。
  5. 构建项目: 运行以下命令构建项目:
    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'。

基本使用方法

  1. 启动 MCP 服务器:在 MCP 客户端中配置上述服务器配置信息,客户端将自动启动 Trello MCP Server。
  2. 连接服务器:客户端成功启动服务器后,将通过 Stdio 传输协议与服务器建立连接。
  3. 使用 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 的功能。

信息

分类

生产力应用