MCP Server Trello

一个模型上下文协议 (MCP) 服务器，提供与 Trello 看板交互的工具。此服务器能够与 Trello 的 API 无缝集成，同时自动处理速率限制、类型安全和错误处理。

功能

• 完整的 Trello 看板集成: 与卡片、列表和看板活动进行交互
• 内置速率限制: 遵守 Trello 的 API 限制（每个 API 密钥每 10 秒 300 个请求，每个令牌每 10 秒 100 个请求）
• 类型安全实现: 使用 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_TOKEN": "your-token",
        "TRELLO_BOARD_ID": "your-board-id"
      }
    }
  }
}

必需的环境变量

• TRELLO_API_KEY: 您的 Trello API 密钥 (从 https://trello.com/app-key 获取)
• TRELLO_TOKEN: 您的 Trello 令牌 (使用您的 API 密钥生成)
• TRELLO_BOARD_ID: 要交互的 Trello 看板的 ID (在看板 URL 中找到)

可用工具

get_cards_by_list_id

从特定列表获取所有卡片。

{
  name: 'get_cards_by_list_id',
  arguments: {
    listId: string  // Trello 列表的 ID
  }
}

get_lists

检索已配置看板中的所有列表。

{
  name: 'get_lists',
  arguments: {}
}

get_recent_activity

获取看板上的最近活动。

{
  name: 'get_recent_activity',
  arguments: {
    limit?: number  // 可选：要获取的活动数量（默认值：10）
  }
}

add_card_to_list

将新卡片添加到指定的列表。

{
  name: 'add_card_to_list',
  arguments: {
    listId: string,       // 要将卡片添加到的列表的 ID
    name: string,         // 卡片的名称
    description?: string, // 可选：卡片的描述
    dueDate?: string,    // 可选：截止日期（ISO 8601 格式）
    labels?: string[]    // 可选：标签 ID 数组
  }
}

update_card_details

更新现有卡片的详细信息。

{
  name: 'update_card_details',
  arguments: {
    cardId: string,       // 要更新的卡片的 ID
    name?: string,        // 可选：卡片的新名称
    description?: string, // 可选：新描述
    dueDate?: string,    // 可选：新的截止日期（ISO 8601 格式）
    labels?: string[]    // 可选：新的标签 ID 数组
  }
}

archive_card

将卡片发送到存档。

{
  name: 'archive_card',
  arguments: {
    cardId: string  // 要存档的卡片的 ID
  }
}

add_list_to_board

将新列表添加到看板。

{
  name: 'add_list_to_board',
  arguments: {
    name: string  // 新列表的名称
  }
}

archive_list

将列表发送到存档。

{
  name: 'archive_list',
  arguments: {
    listId: string  // 要存档的列表的 ID
  }
}

get_my_cards

获取分配给当前用户的所有卡片。

{
  name: 'get_my_cards',
  arguments: {}
}

速率限制

服务器实现了令牌桶算法进行速率限制，以符合 Trello 的 API 限制：

• 每个 API 密钥每 10 秒 300 个请求
• 每个令牌每 10 秒 100 个请求

速率限制是自动处理的，如果达到限制，请求将被排队。

错误处理

服务器为各种场景提供详细的错误消息：

• 无效的输入参数
• 超过速率限制
• API 身份验证错误
• 网络问题
• 无效的看板/列表/卡片 ID

开发

前提条件

• Node.js 16 或更高版本
• npm 或 yarn

设置

1. 克隆存储库

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

2. 安装依赖项

npm install

3. 构建项目

npm run build

运行测试

npm test

贡献

欢迎贡献！请阅读我们的 贡献指南，了解我们的行为准则以及提交拉取请求的流程。

许可证

此项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

鸣谢

• 使用 模型上下文协议 SDK 构建
• 使用 Trello REST API