
MCP Server Trello

2025.01.04
24
TypeScript项目管理自动化任务管理团队协作交流协作
MCP Server Trello 是一个基于 Model Context Protocol (MCP) 的服务,专门用于与 Trello 看板进行交互。该服务提供了与 Trello API 的无缝集成,自动处理速率限制、类型安全和错误处理。
View on GitHub
Overview
基本能力
产品定位
MCP Server Trello 是一个专门用于与 Trello 看板进行交互的服务,提供了一系列工具来管理和操作 Trello 看板、列表和卡片。
核心功能
- 完整的 Trello 看板集成:支持与卡片、列表和看板活动的交互。
- 内置速率限制:自动遵守 Trello 的 API 限制(每个 API 密钥 300 请求/10秒,每个令牌 100 请求/10秒)。
- 类型安全实现:使用 TypeScript 编写,具有全面的类型定义。
- 输入验证:对所有 API 输入进行健壮的验证。
- 错误处理:提供详细的错误消息,处理各种错误场景。
适用场景
- 项目管理工具集成
- 自动化任务管理
- 团队协作工具开发
工具列表
- get_cards_by_list_id:获取特定列表中的所有卡片。
- get_lists:从配置的看板中检索所有列表。
- get_recent_activity:获取看板上的最近活动。
- add_card_to_list:向指定列表添加新卡片。
- update_card_details:更新现有卡片的详细信息。
- archive_card:将卡片归档。
- add_list_to_board:向看板添加新列表。
- archive_list:将列表归档。
- get_my_cards:获取分配给当前用户的所有卡片。
常见问题解答
- 速率限制:服务器使用令牌桶算法自动处理速率限制。
- 错误处理:提供详细的错误消息,包括无效输入参数、速率限制超出、API 认证错误等。
使用教程
使用依赖
- Node.js 16 或更高版本
- npm 或 yarn
安装教程
npm install @modelcontextprotocol/mcp-server-trello
配置
在 MCP 设置文件中添加以下配置:
{
"mcpServers": {
"trello": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-trello"],
"env": {
"TRELLO_API_KEY": "your-api-key",
"TRELLO_TOKEN": "your-token",
"TRELLO_BOARD_ID": "your-board-id"
}
}
}
}
调试方式
- 克隆仓库:
git clone https://github.com/modelcontextprotocol/server-trello.git
cd server-trello
- 安装依赖:
npm install
- 构建项目:
npm run build
- 运行测试:
npm test