使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 提供与 Trello 任务管理工具集成的能力。通过此 MCP 服务器，LLM 可以调用预定义的工具来操作 Trello 看板，例如检索卡片、创建列表、更新任务状态等。

主要功能点

Trello 看板集成: 提供全面的 Trello 看板操作工具，包括卡片、列表和活动管理。
速率限制处理: 内置速率限制机制，符合 Trello API 的速率限制要求，避免请求超限。
类型安全: 使用 TypeScript 开发，提供类型定义，提高代码质量和可维护性。
输入验证: 对所有 API 输入进行严格验证，确保请求参数的有效性。
错误处理: 提供友好的错误处理机制，返回清晰的错误信息。

安装步骤

克隆仓库:

git clone https://github.com/hrs-asano/claude-mcp-trello.git
cd claude-mcp-trello

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

要将此 MCP 服务器集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端以连接到此服务器。以下是一个 'claude_desktop_config.json' 配置文件示例，您需要根据实际情况修改：

{
  "mcpServers": {
    "trello": {  // 服务器名称，可以自定义
      "command": "/path/to/your/node",  // Node.js 的执行路径，例如：/usr/local/bin/node，请替换为您的 Node.js 路径
      "args": [
        "/path/to/claude-mcp-trello/build/index.js" // 服务器入口文件路径，请替换为您的项目 build 目录下的 index.js 路径，例如：/Users/yourname/claude-mcp-trello/build/index.js
      ],
      "env": {
        "TRELLO_API_KEY": "YOUR_TRELLO_API_KEY",  // 您的 Trello API 密钥，请替换为您的密钥
        "TRELLO_TOKEN": "YOUR_TRELLO_TOKEN",  // 您的 Trello 用户 Token，请替换为您的 Token
        "TRELLO_BOARD_ID": "YOUR_TRELLO_BOARD_ID"  // 您的 Trello 看板 ID，请替换为您的看板 ID
      }
    }
  }
}

请注意替换上述配置中的 '/path/to/your/node'、'/path/to/claude-mcp-trello/build/index.js'、'YOUR_TRELLO_API_KEY'、'YOUR_TRELLO_TOKEN' 和 'YOUR_TRELLO_BOARD_ID' 为您实际环境中的值。

基本使用方法

配置完成后，MCP 客户端将能够发现并调用此服务器提供的 Trello 工具。您可以使用 LLM 客户端，通过自然语言指令，例如：

"获取 '待办事项' 列表中的所有卡片" (对应 'trello_get_cards_by_list' 工具，需要提供列表 ID)
"在 '进行中' 列表中创建一个名为 '撰写报告' 的卡片" (对应 'trello_add_card' 工具，需要提供列表 ID 和卡片名称)
"将卡片 '撰写报告' 归档" (对应 'trello_archive_card' 工具，需要提供卡片 ID)

具体工具的使用和参数，请参考仓库 README.md 文件中 Available Tools 章节的描述和 'inputSchema' 定义。

关键词