使用说明

项目简介

Trello Server MCP 是一个基于 Model Context Protocol (MCP) 的服务器，它充当 LLM（大语言模型）客户端与 Trello 项目管理工具之间的桥梁。通过此服务器，LLM 应用可以安全、可控地访问和操作 Trello 看板，实现任务管理、项目跟踪等功能。

主要功能点

Trello 看板集成: 提供丰富的工具，允许 LLM 客户端操作 Trello 看板中的卡片、列表以及查看看板活动。
速率限制处理: 内置速率限制机制，遵循 Trello API 的速率限制策略，保证服务的稳定性和可靠性。
类型安全: 使用 TypeScript 开发，提供类型安全保障，减少错误。
输入验证: 对所有 API 输入进行严格验证，确保请求的有效性。
错误处理: 提供清晰的错误信息，方便调试和问题排查。

安装步骤

确保你的环境中已安装 Node.js 和 npm。

打开终端，执行以下命令安装 Trello Server MCP：

npm install @modelcontextprotocol/mcp-server-trello

服务器配置

要将 Trello Server MCP 集成到 MCP 客户端，你需要在客户端的 MCP 配置文件中添加以下服务器配置信息。请根据你的 Trello API 密钥、Token 和看板 ID 替换相应的占位符。

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/mcp-server-trello"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",  // 你的 Trello API 密钥 (从 https://trello.com/app-key 获取)
        "TRELLO_TOKEN": "your-token",      // 你的 Trello Token (使用 API 密钥生成)
        "TRELLO_BOARD_ID": "your-board-id" // 你要操作的 Trello 看板 ID (在看板 URL 中找到)
      }
    }
  }
}

配置参数说明:

'server name': 'trello' (服务器名称，客户端用此名称引用)
'command': 'npx' (用于启动服务器的命令，这里使用 npx 运行 npm 包)
'args': '["-y", "@modelcontextprotocol/mcp-server-trello"]' (传递给 'command' 的参数，'-y' 用于跳过 'npm install' 的确认提示，'@modelcontextprotocol/mcp-server-trello' 是要执行的 npm 包名)
'env': 环境变量配置
- 'TRELLO_API_KEY': Trello API 密钥，用于身份验证。
- 'TRELLO_TOKEN': Trello 用户 Token，用于授权访问用户数据。
- 'TRELLO_BOARD_ID': 目标 Trello 看板的 ID。

注意: 请务必妥善保管你的 'TRELLO_API_KEY' 和 'TRELLO_TOKEN'，避免泄露。

基本使用方法

配置完成后，LLM 客户端可以通过 MCP 协议调用 Trello Server MCP 提供的工具来操作 Trello 看板。以下是一些可用的工具及其使用示例：

1. 获取指定列表的卡片 (get_cards_by_list_id)

{
  "tool_call": {
    "server_name": "trello",
    "tool_name": "get_cards_by_list_id",
    "arguments": {
      "listId": "your-list-id"  // 替换为你的 Trello 列表 ID
    }
  }
}

2. 获取看板中的所有列表 (get_lists)

{
  "tool_call": {
    "server_name": "trello",
    "tool_name": "get_lists",
    "arguments": {}
  }
}

3. 获取看板的近期活动 (get_recent_activity)

{
  "tool_call": {
    "server_name": "trello",
    "tool_name": "get_recent_activity",
    "arguments": {
      "limit": 5  // 可选，限制返回活动数量，默认为 10
    }
  }
}

4. 在列表中添加卡片 (add_card_to_list)

{
  "tool_call": {
    "server_name": "trello",
    "tool_name": "add_card_to_list",
    "arguments": {
      "listId": "your-list-id",   // 目标列表 ID
      "name": "New Task",        // 卡片名称
      "description": "Task details...", // 可选，卡片描述
      "dueDate": "2024-01-15T12:00:00Z", // 可选，截止日期 (ISO 8601 格式)
      "labels": ["label-id-1", "label-id-2"] // 可选，标签 ID 数组
    }
  }
}

其他工具: 仓库的 README.md 文件中还列出了 'update_card_details', 'archive_card', 'add_list_to_board', 'archive_list', 'get_my_cards' 等工具，你可以参考 README.md 中的 "Available Tools" 部分了解更多工具的使用方法和参数。

通过这些工具，LLM 客户端可以与 Trello 看板进行深度集成，实现更智能化的工作流程。

关键词