MCP Server Trello

基本能力

产品定位

MCP Server Trello 是一个用于与 Trello 看板进行交互的中间件服务，旨在简化 Trello API 的集成和管理。

核心功能

• 完整的 Trello 看板集成：支持与卡片、列表和看板活动的交互。
• 内置速率限制：自动遵守 Trello API 的速率限制（每个 API 密钥 300 次请求/10秒，每个令牌 100 次请求/10秒）。
• 类型安全实现：使用 TypeScript 编写，具有全面的类型定义。
• 输入验证：对所有 API 输入进行健壮的验证。
• 错误处理：提供详细的错误消息，处理各种错误场景。

适用场景

• 项目管理工具集成：将 Trello 看板集成到现有的项目管理工具中。
• 自动化工作流：自动化 Trello 卡片和列表的创建、更新和归档。
• 团队协作：通过 API 实现团队协作的自动化管理。

工具列表

1. get_cards_by_list_id：获取特定列表中的所有卡片。
2. get_lists：从配置的看板中检索所有列表。
3. get_recent_activity：获取看板上的最近活动。
4. add_card_to_list：将新卡片添加到指定列表。
5. update_card_details：更新现有卡片的详细信息。
6. archive_card：将卡片归档。
7. add_list_to_board：将新列表添加到看板。
8. archive_list：将列表归档。
9. get_my_cards：获取分配给当前用户的所有卡片。

常见问题解答

• 速率限制：服务器使用令牌桶算法自动处理速率限制。
• 错误处理：提供详细的错误消息，包括无效输入、速率限制超出、API 认证错误等。

使用教程

使用依赖

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

安装教程

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"
      }
    }
  }
}

调试方式

1. 克隆仓库

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

1. 安装依赖

npm install

1. 构建项目

npm run build

1. 运行测试

npm test

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。