Trello MCP Cloudflare

Cloudflare Workers上的Trello MCP服务器

提供全面Trello集成的模型上下文协议（MCP）服务器，部署在Cloudflare Workers上，具有安全身份验证功能。

🚀 实时部署

服务器URL: https://trello-mcp-cloudflare-v2.matthias-51d.workers.dev

端点:

• 苏格兰和南方能源公司运输: /sse （持久连接的服务器发送事件）
• HTTP传输: /mcp （通过HTTP的JSON-RPC用于简单请求）

🔧 特性

支持Trello操作：

• 板子：列出、获取、创建板
• 列表：获取列表，创建列表
• 卡片：获取、创建、更新、移动、删除卡片
• 评论：添加和检索卡片注释
• 标签：管理板标签和卡标签
• 成员：管理董事会成员和卡片分配
• 检查清单：创建检查表并管理检查表项目
• 搜索：在Trello工作区中搜索卡片
• 附件：将URL附加到卡片

🔐 认证

服务器使用具有环境变量的安全身份验证：

所需的环境变量：

• TRELLO_API_KEY：您的Trello API密钥(拿过来)
• TRELLO_TOKEN：您的Trello代币(在此处生成)
• SHARED_SECRET：MCP身份验证的共享密钥

身份验证方法：

1. URL参数: ?secret=your_shared_secret
2. 认证头: Authorization: Bearer your_shared_secret

📦 设置和部署

先决条件：

• Node.js 18+
• Cloudflare帐户
• Trello API证书

地方发展：

# Clone the repository
git clone https://github.com/M-Kampmann/trello-mcp-cloudflare.git
cd trello-mcp-cloudflare

# Install dependencies
npm install

# Copy environment variables template
cp .dev.vars.example .dev.vars

# Edit .dev.vars with your actual credentials
# TRELLO_API_KEY=your_api_key
# TRELLO_TOKEN=your_token
# SHARED_SECRET=your_secret

# Start local development server
npm run dev

部署到Cloudflare：

# Set production secrets
wrangler secret put TRELLO_API_KEY
wrangler secret put TRELLO_TOKEN
wrangler secret put SHARED_SECRET

# Deploy to Cloudflare Workers
npm run deploy

🔌 使用示例

测试身份验证：

# Test with correct secret (should work)
curl "https://trello-mcp-cloudflare-v2.matthias-51d.workers.dev/sse?secret=your_secret"

# Test with wrong secret (should return 401)
curl "https://trello-mcp-cloudflare-v2.matthias-51d.workers.dev/sse?secret=wrong_secret"

MCP客户端集成：

# Using mcp-remote proxy
npx mcp-remote https://trello-mcp-cloudflare-v2.matthias-51d.workers.dev/sse?secret=your_secret

🖥️ Claude桌面集成

添加到您的Claude Desktop配置(claude_desktop_config.json):

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://trello-mcp-cloudflare-v2.matthias-51d.workers.dev/sse?secret=your_shared_secret"
      ]
    }
  }
}

🛠️ 发展

项目结构：

├── src/
│   └── index.ts          # Main MCP server implementation
├── wrangler.toml         # Cloudflare Workers configuration
├── package.json          # Dependencies and scripts
├── .dev.vars.example     # Environment variables template
└── README.md            # This file

可用工具：

• listBoards -获取所有可访问的板
• getBoard -获取特定的电路板详细信息
• createBoard -创建新板
• getLists -从公告板获取列表
• createList -创建新列表
• getCards -从列表中获取卡片
• getBoardCards -从板上获取所有卡片
• getCard -获取特定卡详细信息
• createCard -创建新卡
• updateCard -更新卡属性
• moveCard -在列表之间移动卡片
• deleteCard -删除卡片
• addComment -在卡片上添加评论
• getComments -获取卡片评论
• addLabel -为卡片添加标签
• removeLabel -从卡上删除标签
• getBoardLabels -获取电路板标签
• createLabel -创建新标签
• addMemberToCard -将成员分配到卡
• removeMemberFromCard -从卡中删除成员
• getBoardMembers -获取董事会成员
• createChecklist -在卡片上创建检查表
• addChecklistItem -将项目添加到检查表中
• getCardChecklists -获取卡片清单
• searchCards -按查询搜索卡片
• attachUrlToCard -将URL附加到卡
• getCurrentUser -获取当前用户信息
• archiveListCards -将列表中的所有卡片存档

🔒 安全

• 所有API凭证均作为Cloudflare Workers机密存储
• 所有端点都需要身份验证
• 为web客户端正确配置CORS
• 日志中没有暴露敏感数据

📝 许可证

MIT许可证-有关详细信息，请参阅许可证文件

🤝 贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 彻底测试
5. 提交拉取请求

🐛 故障排除

常见问题：

身份验证错误:

• 验证您的 SHARED_SECRET 设置正确
• 检查Trello API证书是否有效
• 确保使用正确的URL参数格式

连接问题:

• 验证服务器URL是否可访问
• 检查CORS标头是否设置正确
• 在使用MCP客户端之前，先使用curl进行测试

部署问题:

• 确保在Cloudflare Workers中设置了所有机密
• 检查wrangler.toml配置
• 验证Node.js兼容性设置

如需更多帮助，请查看 Cloudflare Workers文档 或 MCP规范.