Advanced Trello MCP Server

🚀 高级Trello MCP服务器

Trello与Cursor AI集成的增强型模型上下文协议服务器\ 强化生产的API层、批处理工具和附件下载

TypeScript API Trello MCP协议 许可证

📋 概述

这是一个 加强版 Trello MCP服务器提供Trello和Cursor AI（以及类似的MCP客户端）之间的全面集成。它包括 约35个工具 跨板、列表、卡片、标签和操作，加上 可靠的HTTP层 适合大量或连续使用API。

✨ 特性

🛡️ 可靠性（生产测试）

所有Trello呼叫（MCP 资源 和 工具)在中浏览共享客户端 src/utils/api.ts:

• HTTPS保持活动 --重用TLS连接（有助于避免突发流量上的CloudFront/CDN连接混乱）
• **fetchWithRetry\*\*--~60s超时，带抖动的指数回退（最多7次尝试），网络错误重试和5xx
• 滑动窗口速率限制 --约80个请求/10秒（互斥保护）
• 429处理 --尊重 Retry-After 当存在时

🎯 API覆盖范围（当前）

🔧 其他

• TypeScript + 萨德 工具输入验证
• 批量操作 --代理商往返次数减少(create-cards, move-cards, archive-cards, add-comments等等）
• 附属管道 --列出元数据+可选下载到磁盘（见下文）

🚀 快速开始

先决条件

• Node.js 18+
• Trello API密钥和令牌
• 游标（或任何MCP客户端）

安装

1. 克隆仓库

 git clone https://github.com/adriangrahldev/advanced-trello-mcp-server.git
 cd advanced-trello-mcp-server

1. 安装依赖项

 npm install

1. 构建项目

 npm run build

1. 配置环境变量

 export TRELLO_API_KEY="your_api_key"
 export TRELLO_API_TOKEN="your_api_token"

1. 配置光标MCP

添加到您的 ~/.cursor/mcp.json （为您的机器调整了路径）：

🛠️ 可用工具

📋 列表（10）

• get-lists --在板上列出
• create-list / update-list / archive-list
• move-list-to-board
• get-list-actions / get-list-board / get-list-cards
• archive-all-cards-in-list / move-all-cards-in-list

🎯 卡片（12）

• create-card --可选 **due\*\*以及 **start** （ISO 8601）
• create-cards --批量创建；每张卡可能包括 **due** / **start**
• update-card --名称和/或描述
• move-card / move-cards
• add-comment / **add-comments** （对多张卡片进行批量评论）
• get-tickets-by-list
• archive-card / archive-cards
• **get-card-attachments** --元数据+ commentContext （例如评论截图）
• **download-card-attachments** --将文件下载到文件夹（编号文件+ _manifest.json).文件URL通常需要 OAuth风格 Authorization 头球 （不是查询字符串键/令牌）；这个工具可以处理这个问题。

🏷️ 标签（8）

• create-label / create-labels
• add-label / add-labels
• get-label / update-label / delete-label / update-label-field

📊 行动（4）

• get-action --具有可选的显示/实体/成员参数
• update-action / delete-action
• get-action-reactions

🏢 董事会（1）

• get-boards

❓ 为什么旧的Pull Request在GitHub上仍然“打开”？

GitHub将PR标记为 合并 仅当您合并时 那个PR （绿色的“合并拉取请求”按钮），或者当PR分支以GitHub链接到PR的方式合并时。

如果你 精心挑选、复制文件或在本地合并 进入 main 和 推 main，代码在repo上，但是 PR保持开放 直到你：

1. 关闭PR 手动添加注释，例如： *“着陆了 main 通过承诺\*\*--谢谢！”*
2. 或使用 GitHub的合并 下次流动时，PR会自动关闭。

基于分叉的PR冲突是正常的；解决您的机器并推动 main 没关系——之后就关闭公关，这样贡献者就知道它已经完成了。

📈 路线图

计划扩大Trello API的覆盖范围（清单、成员、网络挂钩、搜索等）。PR欢迎。

🔧 发展

项目结构

advanced-trello-mcp-server/
├── src/
│   ├── index.ts
│   ├── tools/       # boards, lists, cards, labels, actions
│   ├── types/
│   └── utils/       # api.ts — fetchWithRetry, keep-alive, rate limit
├── build/
├── scripts/build.js
├── package.json
└── README.md

建筑

npm run build    # TypeScript + shebang on build/index.js
npm run compile  # tsc only

跨平台构建 （Windows/macOS/Linux）：编译TS，添加 #!/usr/bin/env node，在Unix上设置执行位。

🤝 贡献

1. 分叉存储库
2. 分公司(git checkout -b feature/...)
3. 承诺(常规提交 鼓励）
4. 打开拉取请求

如果维护者将你的工作合并到GitHub PR UI之外，他们可能会用登录提交的链接关闭PR——确实如此 不 意思是你的贡献没有被接受。

📚 API文档

工具遵循 Trello REST API输入已通过Zod进行了验证。

🐛 故障排除

📄 许可证

麻省理工学院——见 许可证.

🙏 致谢

• 原始Trello MCP服务器-- yairhaimo/trello mcp服务器
• API Trello · 主控程序 · 光标

______________________________________________________________________

建于❤️ Cursor AI社区