MCP 服务器 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

根据列表ID获取所有卡片。

{
  name: 'get_cards_by_list_id',
  arguments: {
    listId: string  // 列表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, // 可选：卡片描述
    due?: Date,          // 可选：截止日期
    labels?: string[]     // 可选：标签ID数组
  }
}

add_comment_to_card

在指定卡片下添加评论。

{
  name: 'add_comment_to_card',
  arguments: {
    cardId: string, // 卡片ID
    text: string     // 评论文本
  }
}

速率限制

默认情况下，Trello API的免费层限制为：

• 每分钟20个请求
• 每小时1000个请求

如果您需要更高的速率限制，请考虑升级到付费计划。

错误处理

所有API调用都会返回一个包含以下字段的对象：

{
  success: boolean,       // 表示操作是否成功的布尔值
  data?: any,           // 成功时的响应数据
  error?: {
    message: string      // 错误消息
  }
}

开发

克隆仓库

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

安装依赖项

npm install

构建项目

npm run build

运行测试

npm test

贡献

欢迎贡献！请阅读我们的贡献指南以了解代码规范和提交拉取请求的过程。

许可证

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

致谢

• 使用modelcontextprotocol SDK构建
• 使用Trello REST API