MCP 服务器 - Trello

一个 Model Context Protocol (MCP) 服务器，提供与 Trello 看板交互的工具。此服务器在集成 Trello 的 API 时自动处理速率限制、类型安全和错误处理。

功能

• 完整的 Trello 看板集成：与卡片、列表和看板活动进行交互
• 内置速率限制：尊重 Trello 的 API 限制（每个 API 键 300 次请求/10 秒，每个令牌 100 次请求/10 秒）
• 类型安全实现：使用 TypeScript 编写，带有全面的类型定义
• 输入验证：所有 API 输入的稳健验证
• 错误处理：优雅的错误处理和详细消息

安装

npm install @modelcontextprotocol/mcp-server-trello

配置

将服务器添加到您的 MCP 设置文件中，如下所示：

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-trello"],
      "env": {
        "TRELLO_API_KEY": "your-api-key", // 您的 Trello API 键
        "TRELLO_TOKEN": "your-token",     // 您的 Trello 令牌
        "TRELLO_BOARD_ID": "your-board-id" // 配置的 Trello 看板 ID
      }
    }
  }
}

可用工具

以下是服务器提供的功能及其说明：

获取看板信息

// 获取指定看板的基本信息
const board = await trello.getBoard(boardId);
// 返回值：包含看板名称、描述和成员等信息的对象

创建新列表

// 在指定看板上创建一个新列表
const newList = await trello.createList(boardId, "任务清单");

添加卡片到列表

// 将卡片添加到指定列表中
const card = await trello.addCardToList(listId, "完成项目");

速率限制

服务器每分钟最多处理 50 个请求，以防止滥用和确保稳定性。

错误处理

所有 API 调用都带有重试机制（最多 3 次），并在失败时记录错误日志。

开发信息

克隆仓库

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

安装依赖

npm install

构建项目

npm run build

运行测试

npm test

贡献指南

欢迎贡献！请阅读我们的 中文贡献指南 了解代码规范和提交 Pull Request 的流程。

许可证

此项目使用 MIT 许可证，具体内容在 LICENSE 文件中。

致谢

• 使用 Model Context Protocol SDK
• 基于 Trello REST API 构建