🚀 MCP 服务器 - Trello
MCP 服务器 - Trello 是一个基于 Model Context Protocol (MCP) 的服务器，它为用户提供了与 Trello 看板交互的工具。该服务器在集成 Trello API 时，能够自动处理速率限制、类型安全和错误处理等问题，极大地提升了使用的便捷性和稳定性。
🚀 快速开始
本项目是一个 Model Context Protocol (MCP) 服务器，为您提供与 Trello 看板交互的工具。它能自动处理速率限制、类型安全和错误处理，让您更轻松地集成 Trello API。
✨ 主要特性
- 完整的 Trello 看板集成：可与卡片、列表和看板活动进行交互。
- 内置速率限制：严格遵循 Trello 的 API 限制（每个 API 键 300 次请求/10 秒，每个令牌 100 次请求/10 秒）。
- 类型安全实现：采用 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 API 键
"TRELLO_TOKEN": "your-token", // 您的 Trello 令牌
"TRELLO_BOARD_ID": "your-board-id" // 配置的 Trello 看板 ID
}
}
}
}
速率限制
服务器每分钟最多处理 50 个请求，以此防止滥用并确保稳定性。
错误处理
所有 API 调用都带有重试机制（最多 3 次），并在失败时记录错误日志。
💻 使用示例
基础用法
以下是服务器提供的一些基本功能及其代码示例：
获取看板信息
// 获取指定看板的基本信息
const board = await trello.getBoard(boardId);
// 返回值：包含看板名称、描述和成员等信息的对象
创建新列表
// 在指定看板上创建一个新列表
const newList = await trello.createList(boardId, "任务清单");
添加卡片到列表
// 将卡片添加到指定列表中
const card = await trello.addCardToList(listId, "完成项目");
🔧 技术细节
克隆仓库
git clone https://github.com/modelcontextprotocol/server-trello.git
cd server-trello
安装依赖
npm install
构建项目
npm run build
运行测试
npm test
🤝 贡献指南
欢迎贡献！请阅读我们的 中文贡献指南 了解代码规范和提交 Pull Request 的流程。
📄 许可证
此项目使用 MIT 许可证，具体内容在 LICENSE 文件中。