MCP Trello

这是一个提供与Trello看板交互工具的模型上下文协议（MCP）服务器。该服务器能够无缝集成Trello的API，并自动处理速率限制、类型安全性和错误处理。

功能

• 完整的Trello看板集成：与卡片、列表和看板活动进行交互
• 内置速率限制：遵守Trello的API限制（每个API密钥每10秒300次请求，每个令牌每10秒100次请求）
• 类型安全实现：使用TypeScript编写并具有全面的类型定义
• 输入验证：使用Zod模式对所有API输入进行强大的验证
• 错误处理：优雅的错误处理，带有信息性消息

核心组件

• MCP服务器：这些服务器充当桥梁，暴露API、数据库和代码库给外部AI主机。通过在TypeScript中实现一个MCP服务器，开发者可以以标准化的方式使用JSON-RPC 2.0共享数据源或计算逻辑。
• MCP客户端：这是MCP面向用户的一侧，与服务器通信以查询数据或执行操作。MCP客户端使用TypeScript SDK，确保类型安全的交互和统一的工具使用方法。
• MCP主机：如Claude、Cursor、Windsurf、Cline和其他基于TypeScript的平台协调服务器和客户端之间的请求，确保无缝的数据流。因此，单个MCP服务器可以被多个AI主机访问而无需自定义集成。

可用工具

MCP Trello提供了以下工具来与Trello进行交互：

看板管理

• getMyBoards：检索已认证用户的全部看板（用于查找看板ID）

卡片管理

• getCardsByList：从特定列表获取所有卡片
• getMyCards：获取分配给当前用户的全部卡片（无需看板ID）
• addCard：向指定列表添加新卡片
• updateCard：更新现有卡片的详细信息（名称、描述、截止日期、标签、位置）
• moveCard：将卡片移动到不同的列表或看板
• archiveCard：将卡片发送到存档
• changeCardMembers：向卡片添加或移除成员

列表管理

• getLists：从配置的看板获取所有列表（需要看板ID）
• addList：向看板添加新列表（需要看板ID）
• archiveList：将列表发送到存档

看板信息

• getRecentActivity：获取看板上的最近活动（需要看板ID）

项目结构

mcp-trello/
├── src/
│   ├── index.ts          # 主入口点
│   └── trello/           # Trello API 集成
│       ├── client.ts     # Trello 客户端实现
│       ├── rate-limiter.ts # 速率限制功能
│       └── types.ts      # TypeScript 类型定义
├── docs/                 # 文档
├── package.json          # 项目配置
└── tsconfig.json         # TypeScript 配置

安装

使用Smithery

安装MCP Trello最简单的方法是使用Smithery：

# 对于Claude
npx -y @smithery/cli install @Hint-Services/mcp-trello --client claude

# 对于Cursor
npx -y @smithery/cli install @Hint-Services/mcp-trello --client cursor

# 对于Windsurf
npx -y @smithery/cli install @Hint-Services/mcp-trello --client windsurf

# 对于Cline
npx -y @smithery/cli install @Hint-Services/mcp-trello --client cline

# 对于TypeScript
npx -y @smithery/cli install @Hint-Services/mcp-trello --client typescript

手动安装

pnpm add mcp-trello

配置

在您的MCP设置文件中添加服务器，使用以下配置：

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@Hint-Services/mcp-trello"],
      "env": {
        "trelloApiKey": "your-api-key",
        "trelloToken": "your-token",
        "trelloBoardId": "your-board-id"
      }
    }
  }
}

环境变量

必需

• trelloApiKey：您的Trello API密钥（从https://trello.com/app-key 获取）
• trelloToken：您的Trello令牌（使用您的API密钥生成）

可选

• trelloBoardId：要与其交互的Trello看板的完整24字符ID（对于特定看板的操作是必需的）

查找您的看板ID

重要：看板ID不是您在Trello URL中看到的短码。

例如，如果您的看板URL是https://trello.com/b/a1b2c3d4/my-board，那么短码a1b2c3d4不是看板ID。

要找到您的看板的完整24字符ID：

1. 仅使用您的API密钥和令牌配置服务器（初始时省略trelloBoardId）
2. 使用getMyBoards工具列出您的所有看板
3. 在结果中找到您的看板并复制id字段（不是shortLink）
4. 看板ID看起来像这样：507f1f77bcf86cd799439011（24个字符）
5. 将此完整ID添加到您的配置作为trelloBoardId

注意：一些工具如getMyCards和getMyBoards可以在未配置看板ID的情况下工作。特定看板的工具如getLists、addList和getRecentActivity需要有效的看板ID。

开发者指南

如果您有兴趣为此项目做出贡献或使用此服务器开发自己的工具，请参阅开发指南。

更多信息

有关MCP生态系统进一步的信息，请参考：

• 模型上下文协议文档：详细介绍了MCP架构、设计原则以及更多高级用例。
• Smithery - MCP服务器注册表：发布您的工具到Smithery的指南及最佳实践。
• MCP TypeScript SDK文档：TypeScript SDK的综合文档。
• MCP安全指南：详细的网络安全最佳实践和建议。

关于Hint Services

“未来已经到来，只是分布不均”

——William Gibson，作家

Hint Services是一家精品咨询公司，致力于发展和扩展用户界面如何利用人工智能技术。我们在AI和用户体验交汇处构想雄心壮志，由Ben Hofferber创立并领导。

我们为希望拥抱AI工具而不必成为开发者的设计师团队提供专门的AI研讨会。了解更多关于我们的培训和研讨会。