金大哥 - delorenj_mcp-server-trello MCP 详情

article

README

🚀 MCP 服务器 Trello

MCP 服务器 Trello 是一个模型上下文协议（MCP）服务器，它提供了与 Trello 看板交互的工具。该服务器实现了处理速率限制、类型安全和错误处理的自动化，同时支持与 Trello API 的无缝集成，极大提升了与 Trello 看板交互的效率和稳定性。

🚀 快速开始

你可以按照以下步骤快速将 MCP 服务器 Trello 集成到你的项目中。

✨ 主要特性

完整的 Trello 看板集成：可与卡片、列表和看板活动进行交互，实现对 Trello 看板的全面操作。
内置速率限制：严格遵循 Trello API 的限制，每个 API 密钥每 10 秒可发起 300 个请求，每个令牌每 10 秒可发起 100 个请求，避免因请求超限导致的问题。
类型安全实现：使用 TypeScript 编写，并带有全面的类型定义，确保代码的健壮性和可维护性。
输入验证：对所有 API 输入进行稳健验证，防止因非法输入导致的错误。
错误处理：具备优雅的错误处理机制，能提供详细的错误信息，方便排查问题。

📦 安装指南

在项目中使用 npm 进行安装：

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以了解代码规范和提交拉取请求的过程。

delorenj_mcp-server-trello