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": "你的API密钥", // 获取自 https://trello.com/app-key
        "TRELLO_TOKEN": "你的令牌",     // 使用你的API密钥生成
        "TRELLO_BOARD_ID": "你的看板ID"  // 在看板URL中找到
      }
    }
  }
}

必需的环境变量

• 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
    cardData: {
      idList: string,
      name: string,
      desc?: string,
      pos?: number,
      due?: string,
      dueComplete?: boolean,
      labels?: string[],
      members?: string[],
      comments?: {
        text: string
      }[]
    }
  }
}

update_card

更新现有卡片的信息。

{
  name: 'update_card',
  arguments: {
    cardId: string, // 卡片ID
    cardData: {
      idList?: string,
      name?: string,
      desc?: string,
      pos?: number,
      due?: string,
      dueComplete?: boolean,
      labels?: string[],
      members?: string[],
      comments?: {
        text: string
      }[]
    }
  }
}

delete_card

删除指定卡片。

{
  name: 'delete_card',
  arguments: {
    cardId: string // 卡片ID
  }
}

速率限制

• 每个API密钥每10秒：300个请求
• 每个令牌每10秒：100个请求

许可证

此项目在MIT License下许可，详情请参阅LICENSE文件。

贡献

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