MCP Server Trello

MCP Server Trello

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

Overview

基本能力

产品定位

MCP Server Trello 是一个中间件服务,旨在简化与 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 了解完整条款。