金大哥 - trello-mcp MCP 详情

article

README

🚀 Trello 事项处理流程 (MCP) 服务器

这是一个用于通过 Claude 处理 Trello 事务的 MCP 服务器，能有效协助用户与 Trello API 进行交互，实现各类操作。

🚀 快速开始

本服务器提供了两种安装方式，您可按需选择。

📦 安装指南

使用 uv 管理员

uv add mcp-server-trello --main main.py --config config.yaml

手动运行

python3 main.py

✨ 主要特性

功能表

| 操作 | Board | List | Card | Checklist | Checklist Item | |--------------|-------|-------|------|-----------|----------------| | 读取 | ✅ | ✅ | ✅ | ✅ | ✅ | | 写入 | ❌ | ✅ | ✅ | ✅ | ✅ | | 更新 | ❌ | ✅ | ✅ | ✅ | ✅ | | 删除 | ❌ | ✅ | ✅ | ✅ | ✅ |

详细功能

Board 操作

✅ 读取所有 Boards
✅ 读取特定 Board 的详情

List 操作

✅ 读取 Board 中的所有 Lists
✅ 读取具体 List 的详情
✅ 创建新的 List
✅ 更新 List 名称
✅ 存档（删除）List

Card 操作

✅ 读取 List 中的所有 Cards
✅ 读取具体 Card 的详情
✅ 创建新 Card
✅ 更新 Card 属性
✅ 删除 Card

Checklist 操作

✅ 获取特定 Checklist
✅ 列出 Card 中的所有 Checklists
✅ 创建新的 Checklist
✅ 更新 Checklist
✅ 删除 Checklist
✅ 添加 Checklist 项
✅ 更新 Checklist 项
✅ 删除 Checklist 项

💻 使用示例

基础用法

import requests

# 发送请求到 SSE 端点
response = requests.get('http://localhost:8000/stream', stream=True)

# 处理响应
for event in response.iter_events():
    if event:
        print(event)

示例请求

curl -X POST http://localhost:8000/api/trello/webhook

📚 详细文档

安装配置

在安装过程中，建议先阅读 uv 文档来了解如何管理 MCP 服务。

功能概述

该服务器允许通过 HTTP 请求与 Trello API 进行交互，并提供以下功能：

监听和处理 MCP 事件
支持 SSE（服务器发送事件）协议
提供 RESTful API 接口

🔧 技术细节

请求处理流程

接收 HTTP 请求
解析请求数据
调用 Trello API
处理响应并返回结果

代码结构

# main.py
from fastapi import FastAPI

app = FastAPI()

@app.get("/stream")
async def stream_events():
    # 实现 SSE 逻辑
    pass

@app.post("/api/trello/webhook")
async def handle_trello_webhook():
    # 处理 Trello 回调逻辑
    pass

📄 许可证

文档中未提及相关许可证信息。

⚠️ 故障排除

遇到问题时：

确认 .env 文件中的 Trello API 凭证
检查您在 Trello 工作区的权限是否正确
确保 Claude 桌面应用程序运行最新版本
使用 uv run mcp dev main.py 检查日志输出
查看浏览器中的控制台错误信息

💡 使用说明

若需要自定义或扩展功能，可以参考上述技术细节部分。同时，欢迎在 GitHub Issues 提交问题或建议。如果希望为该项目贡献力量，请先阅读贡献指南。

trello-mcp