AI导哈

Trello MCP集成服务器

一个增强版的Trello MCP服务器，提供Trello与Cursor AI（及类似MCP客户端）的全面集成，包含批量操作和附件下载功能。

  • by adriangrahldev
  • TypeScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 adriangrahldev/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覆盖范围（当前）

区域 工具 注释
列表 10 完整列表生命周期，批量卡片移动
卡片 12 批量创建/移动/存档/评论， 附件
标签 8 包括批量添加
行动 4 获取/更新/删除操作，列出反应
板子 1 列出可访问的板

🔧 其他

  • 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_API_KEY + TRELLO_API_TOKEN；令牌范围(read / write)
找不到工具 重建(npm run build)，重新启动MCP客户端
fetch failed /超时 重试层应该有所帮助；持续429→ 减缓工作流程
附件下载401 使用 download-card-attachments （标头身份验证），不是原始URL ?key=&token=

📄 许可证

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

🙏 致谢

建于❤️ Cursor AI社区

相关 MCP