Trello MCP

🚀 Trello 事項處理流程 (MCP) 服務器

這是一個用於通過 Claude 處理 Trello 事務的 MCP 服務器，能有效協助用戶與 Trello API 進行交互，實現各類操作。

🚀 快速開始

本服務器提供了兩種安裝方式，您可按需選擇。

📦 安裝指南

使用 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 項

💻 使用示例

基礎用法

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 接口

🔧 技術細節

請求處理流程

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

📄 許可證

文檔中未提及相關許可證信息。

⚠️ 故障排除

遇到問題時：

1. 確認 .env 文件中的 Trello API 憑證
2. 檢查您在 Trello 工作區的權限是否正確
3. 確保 Claude 桌面應用程序運行最新版本
4. 使用 uv run mcp dev main.py 檢查日誌輸出
5. 查看瀏覽器中的控制檯錯誤信息

💡 使用說明

若需要自定義或擴展功能，可以參考上述技術細節部分。同時，歡迎在 GitHub Issues 提交問題或建議。如果希望為該項目貢獻力量，請先閱讀 貢獻指南。