deckapp-mcp

MCP-Unterstützung für DeckApp, sodass Tools wie Claude deine Decks erstellen und ausführen können. Es funktioniert mit denselben Deck-Dateien wie die App, unabhängig davon, ob DeckApp geöffnet ist.

Voraussetzungen

DeckApp 3.0 oder neuer, installiert, sodass import deckapp funktioniert. Das .deb legt es unter /usr/lib/python3/dist-packages ab, was eine mit --system-site-packages erstellte virtualenv sehen kann.

Related MCP server: streamdeck-mcp

Installation

git clone https://github.com/prabhatm021/deckapp-mcp.git
cd deckapp-mcp
python3 -m venv --system-site-packages .venv
.venv/bin/pip install .

Überprüfe, ob DeckApp gefunden wurde:

.venv/bin/python -c "import deckapp; print(deckapp.__version__)"

Verbinden

Claude Code:

claude mcp add deckapp -- /path/to/deckapp-mcp/.venv/bin/deckapp-mcp

Claude Desktop oder jeder Client mit einer JSON-Konfiguration:

{
  "mcpServers": {
    "deckapp": {
      "command": "/path/to/deckapp-mcp/.venv/bin/deckapp-mcp"
    }
  }
}

Verwende den vollständigen Pfad. Das deckapp-mcp aus der venv ist dasjenige, das weiß, wo DeckApp liegt.

Tools

Insgesamt 26, die denselben Funktionsumfang wie die App abdecken: Decks erstellen, umbenennen, skalieren, duplizieren, neu anordnen und löschen; Buttons hinzufügen, bearbeiten, verschieben und entfernen; Icons importieren; Umschaltzustände lesen und setzen; ein Deck als JSON exportieren und importieren; ein Deck-Fenster öffnen. Führe zuerst list_decks aus, um zu sehen, welche IDs du hast.

Es gibt außerdem press_button, das den Befehl eines Buttons ausführt und den Exit-Code sowie die Ausgabe zurückgibt. Das erleichtert die Prüfung, ob ein Deck funktioniert, und bedeutet, dass alles, was mit diesem Server verbunden ist, alles ausführen kann, was deine Decks ausführen. Es ist Shell-Zugriff, also behandle es auch so.

Positionen sind nullbasiert; Zeile 0, Spalte 0 ist die obere linke Taste.

Lizenz

MIT