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

一个用于通过 Claude 处理 Trello 事务的 MCP 服务器。

安装

使用 uv 管理员

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

手动运行

python3 main.py

功能表

详细功能

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 项

使用示例

示例使用场景

故障排除

遇到问题时：

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

使用说明

示例代码

import requests

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

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

详细文档

安装配置

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

功能概述

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

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

示例请求

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

面向开发者的文档

如果需要自定义或扩展功能，可以参考以下内容：

请求处理流程

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

代码结构

# 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

贡献与支持

提交问题

欢迎在 GitHub Issues 提交问题或建议。

代码贡献

如果希望为该项目贡献力量，请先阅读 贡献指南。