](https://smithery.ai/server/@Hint-Services/mcp-trello) ](https://www.npmjs.com/package/mcp-trello)
MCP Trello
一种模型上下文协议（MCP）服务器，提供与Trello板交互的工具。该服务器能够与Trello的API无缝集成，同时自动处理速率限制、类型安全和错误处理。
特性
- Trello板完全集成：与卡片、列表和棋盘活动交互
- 内置速率限制：遵守Trello的API限制（每个API密钥300个请求/10秒，每个令牌100个请求/10 s）
- 类型安全实施：用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：从特定列表中获取所有卡片
- 获取卡片：获取分配给当前用户的所有卡（无板ID）
- addCard：将新卡添加到指定列表中
- 更新卡：更新现有卡的详细信息（姓名、描述、到期日期、标签、职位）
- 移动卡片：将卡片移动到其他列表或板
- 档案卡：向档案馆发送一张卡片
- changeCard会员：添加或删除卡中的成员
列表管理
- getLists：从配置的板中检索所有列表（需要板ID）
- addList：向板添加新列表（需要板ID）
- 归档列表：将列表发送到存档
板信息
- 获取最近活动：获取板上最近的活动（需要板ID）
项目结构
mcp-trello/
├── src/
│ ├── index.ts # Main entry point
│ └── trello/ # Trello API integration
│ ├── client.ts # Trello client implementation
│ ├── rate-limiter.ts # Rate limiting functionality
│ └── types.ts # TypeScript type definitions
├── docs/ # Documentation
├── package.json # Project configuration
└── tsconfig.json # TypeScript configuration安装
使用Smithery
安装MCP Trello最简单的方法是使用Smithery：
# For Claude
npx -y @smithery/cli install @Hint-Services/mcp-trello --client claude
# For Cursor
npx -y @smithery/cli install @Hint-Services/mcp-trello --client cursor
# For Windsurf
npx -y @smithery/cli install @Hint-Services/mcp-trello --client windsurf
# For Cline
npx -y @smithery/cli install @Hint-Services/mcp-trello --client cline
# For 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：
- 仅使用API密钥和令牌配置服务器（省略
trelloBoardId最初） - 使用
getMyBoards列出所有电路板的工具 - 在结果中找到您的板并复制
id字段（非shortLink) - 板ID看起来像：
507f1f77bcf86cd799439011（24个字符） - 将此完整ID添加到您的配置中
trelloBoardId
注： 一些工具，如 getMyCards 和 getMyBoards 无需配置板ID即可工作。董事会专用工具，如 getLists, addList，以及 getRecentActivity 需要有效的板ID。
面向开发者
如果您有兴趣为此项目做出贡献或使用此服务器开发自己的工具，请参阅 开发指南.
了解更多
有关MCP生态系统的更多信息，请参阅：
- 模型上下文协议文档：详细介绍MCP架构、设计原则和更高级的使用示例。
- Smithery-MCP服务器注册表：向Smithery发布工具的指南及其注册表的最佳实践。
- MCP TypeScript SDK文档：TypeScript SDK的全面文档。
- MCP安全指南：详细的安全最佳做法和建议。
关于提示服务
“未来已经到来，只是分布不均” - 威廉·吉布森，作家
Hint Services是一家精品咨询公司，其使命是开发和扩展用户界面如何利用人工智能技术。我们在人工智能和用户体验的交叉点构建雄心壮志，由Ben Hofferber创立和领导。
我们为希望在不成为开发人员的情况下采用人工智能工具的设计团队提供专门的人工智能研讨会。 了解更多关于我们的培训和研讨会.