MCP Server Trello

MCP Server Trello

site icon
2025.04.21 0
TypeScriptTrello 集成看板管理自动化工具交流协作
server-trello-mcp 是一个基于 Model Context Protocol (MCP) 的服务,专门用于与 Trello 看板进行交互。该服务提供了与 Trello API 的无缝集成,自动处理速率限制、类型安全和错误处理。
View on GitHub

Overview

基本能力

产品定位

server-trello-mcp 是一个专门用于与 Trello 看板交互的 MCP 服务,旨在简化 Trello API 的集成和使用。

核心功能

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

适用场景

  • 自动化 Trello 看板管理
  • 集成 Trello 到其他工作流中
  • 开发基于 Trello 的自动化工具

工具列表

  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 了解完整条款。