trellio-mcp — MCP-Server für Trello

Ein MCP-Server, der Claude Desktop, Claude Code und Gemini CLI vollen Zugriff auf die Trello-API gewährt. Basiert auf der trellio Async-Client-Bibliothek und dem offiziellen Python MCP SDK. Entwickelt gemäß den BDD-Richtlinien v1.8.0.

Funktionen

• 48 MCP-Tools — 1:1-Abbildung auf trellio-Methoden, plus ein zusammengesetztes get_board_overview-Tool

• 2 Ressourcenvorlagen — trello://board/{id} und trello://card/{id} für das Laden umfangreicher Kontexte

• 3 Prompts — summarize_board, create_sprint, daily_standup als Workflow-Verknüpfungen

• Integrierter Authentifizierungsablauf — python -m trello_mcp auth öffnet den Browser, der Benutzer klickt auf "Zulassen", das Token wird sicher gespeichert

• Strukturierte Fehlerbehandlung — Trello-API-Fehler werden in klare, umsetzbare MCP-Fehlermeldungen übersetzt

• stdio-Transport — läuft als lokaler Subprozess, keine Netzwerkangriffsfläche

Related MCP server: Trello MCP Server

Tools

Karten-Tools unterstützen pos (oben/unten), idLabels (durch Kommas getrennt), due (ISO 8601) und dueComplete (true/false) beim Erstellen und Aktualisieren.

Voraussetzungen

• Python 3.10+

• Ein Trello-API-Schlüssel (füge http://localhost:8095 zu den erlaubten Ursprüngen hinzu)

Installation

Smithery

npx @smithery/cli install gupta/trellio-mcp --client claude

Verwendung von pipx (empfohlen)

Zur globalen Installation, damit der trellio-mcp-Befehl in Ihrem PATH verfügbar ist:

pipx install trellio-mcp

Alternativ können Sie es direkt ausführen, ohne es zu installieren:

pipx run trellio-mcp

(Hinweis: Wenn Sie pipx run verwenden, muss Ihre MCP-Client-Konfiguration ebenfalls pipx als Befehl und run trellio-mcp als Argumente verwenden.)

Verwendung von pip

pip install trellio-mcp

Aus dem Quellcode

git clone https://github.com/scaratec/trellio-mcp.git
cd trellio-mcp
python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"

Authentifizierung

Interaktiv (empfohlen)

Führen Sie den Auth-Befehl auf jedem Rechner aus, um Ihr Trello-Konto zu verbinden:

Wenn Sie es global installiert haben (pipx install oder pip install):

TRELLO_API_KEY=your_api_key trellio-mcp auth

Bei Verwendung der direkten Ausführung (pipx run):

TRELLO_API_KEY=your_api_key pipx run trellio-mcp auth

Dies öffnet einen Browser, in dem Sie die App autorisieren. Das Token wird automatisch erfasst und unter ~/.config/trellio-mcp/credentials.json (Berechtigungen 0600) gespeichert.

Nach der Authentifizierung sind keine Umgebungsvariablen erforderlich — der Server liest die gespeicherten Anmeldedaten beim Start.

Umgebungsvariablen (Fallback)

Wenn keine gespeicherten Anmeldedaten gefunden werden, greift der Server auf Umgebungsvariablen zurück:

export TRELLO_API_KEY=your_api_key
export TRELLO_TOKEN=your_token

MCP-Client-Konfiguration

Claude Desktop

Hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "trello": {
      "command": "pipx",
      "args": ["run", "trellio-mcp"]
    }
  }
}

Wenn Sie die Authentifizierung über Umgebungsvariablen anstelle von gespeicherten Anmeldedaten verwenden, fügen Sie hinzu:

"env": {
  "TRELLO_API_KEY": "your_api_key",
  "TRELLO_TOKEN": "your_token"
}

Claude Code

Hinzufügen zu ~/.claude/settings.json oder Projekt .claude/settings.json:

{
  "mcpServers": {
    "trello": {
      "command": "pipx",
      "args": ["run", "trellio-mcp"]
    }
  }
}

Gemini CLI

Hinzufügen zu ~/.gemini/settings.json:

{
  "mcpServers": {
    "trello": {
      "command": "pipx",
      "args": ["run", "trellio-mcp"]
    }
  }
}

Architektur

MCP Client (Claude / Gemini)
    │ stdio (JSON-RPC)
    ▼
trellio-mcp (FastMCP)
    │ async/await
    ▼
trellio (httpx)
    │ HTTPS
    ▼
Trello API

Wichtige Entscheidungen (dokumentiert in docs/adr/):

Testen

Das Projekt verwendet BDD mit behave, gemäß den BDD-Richtlinien v1.8.0.

PYTHONPATH=src .venv/bin/python -m behave

17 features passed, 0 failed, 0 skipped
163 scenarios passed, 0 failed, 0 skipped
970 steps passed, 0 failed, 0 skipped

Testarchitektur:

• AsyncMock(spec=TrellioClient) — Mock an der Client-Grenze, nicht HTTP

• Validierung der Persistenz über Mock-Aufrufprotokolle (§4.3)

• Vermeidung von Hardcoding durch Szenario-Gliederungen mit >= 2 Varianten (§2.3)

• Schicht-für-Schicht-Aufzählung von Fehlerpfaden (§4.5)

• Unabhängiges Spezifikations-Audit gemäß §13

Siehe Fallstudie für einen detaillierten Bericht über den BDD-gesteuerten Entwicklungsprozess.

Projektstruktur

trellio-mcp/
├── src/trello_mcp/
│   ├── __init__.py        # Tool registration
│   ├── __main__.py        # Entry point (server + auth)
│   ├── server.py          # FastMCP instance + client mgmt
│   ├── auth.py            # OAuth flow + credential storage
│   ├── errors.py          # Error translation (ADR 007)
│   ├── tools/             # 10 modules, 48 tools
│   ├── resources.py       # 2 resource templates
│   └── prompts.py         # 3 prompts
├── features/              # 17 BDD feature files
│   └── steps/             # Step definitions
├── docs/
│   ├── adr/               # 7 Architecture Decision Records
│   ├── tool-design.md     # Scenario-driven tool analysis
│   └── case-study-bdd-mcp-server.md
└── pyproject.toml

Veröffentlichung

PyPI

uv build
twine upload dist/trellio_mcp-<version>*

Smithery

Der Namespace ist gupta. Aktualisieren Sie das Release nach einer neuen PyPI-Version:

npx @smithery/cli mcp publish "https://github.com/scaratec/trellio-mcp" -n gupta/trellio-mcp

Aktualisieren Sie auch die fixierte Version in smithery.yaml unter commandFunction.

Lizenz

Dieses Projekt ist unter der GNU General Public License v3.0 lizenziert — siehe die LICENSE-Datei für Details.