MCP Server Trello

MCP Server Trello

一个用于与 Trello 看板交互的 Model Context Protocol（MCP）服务。此服务可与 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  // ID of the Trello list
  }
}

get_lists

获取已配置看板中的所有列表。

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

get_recent_activity

获取看板的近期活动。

{
  name: 'get_recent_activity',
  arguments: {
    limit?: number  // Optional: Number of activities to fetch (default: 10)
  }
}

add_card_to_list

向指定列表添加新卡片。

{
  name: 'add_card_to_list',
  arguments: {
    listId: string,       // ID of the list to add the card to
    name: string,         // Name of the card
    description?: string, // Optional: Description of the card
    dueDate?: string,    // Optional: Due date (ISO 8601 format)
    labels?: string[]    // Optional: Array of label IDs
  }
}

update_card_details

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

{
  name: 'update_card_details',
  arguments: {
    cardId: string,       // ID of the card to update
    name?: string,        // Optional: New name for the card
    description?: string, // Optional: New description
    dueDate?: string,    // Optional: New due date (ISO 8601 format)
    labels?: string[]    // Optional: New array of label IDs
  }
}

archive_card

将卡片移至归档。

{
  name: 'archive_card',
  arguments: {
    cardId: string  // ID of the card to archive
  }
}

add_list_to_board

向看板添加新列表。

{
  name: 'add_list_to_board',
  arguments: {
    name: string  // Name of the new list
  }
}

archive_list

将列表移至归档。

{
  name: 'archive_list',
  arguments: {
    listId: string  // ID of the list to archive
  }
}

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 文件。

致谢

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