deckapp-mcp

Soporte MCP para DeckApp, para que herramientas como Claude puedan crear y ejecutar tus decks. Funciona con los mismos archivos de deck que la app, esté DeckApp abierta o no.

Requisitos

DeckApp 3.0 o superior, instalada de modo que import deckapp funcione. El .deb la coloca en /usr/lib/python3/dist-packages, que un virtualenv puede ver si lo creas con --system-site-packages.

Related MCP server: streamdeck-mcp

Instalación

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

Comprueba que encontró DeckApp:

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

Conectarlo

Claude Code:

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

Claude Desktop, o cualquier cliente con una configuración JSON:

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

Usa la ruta completa. El deckapp-mcp del venv es el que sabe dónde está DeckApp.

Herramientas

Hay 26, que cubren lo mismo que la app: crear, renombrar, redimensionar, duplicar, reordenar y eliminar decks; añadir, editar, mover y quitar botones; importar iconos; leer y establecer estados de conmutación; exportar e importar un deck como JSON; abrir una ventana de deck. Ejecuta list_decks primero para ver qué IDs tienes.

También está press_button, que ejecuta el comando de un botón y devuelve el código de retorno y la salida. Eso facilita comprobar que un deck funciona, y significa que cualquier cosa conectada a este servidor puede ejecutar lo que sea que ejecuten tus decks. Es acceso a shell, así que trátalo como tal.

Las posiciones están indexadas desde cero; la fila 0 y la columna 0 corresponden a la tecla superior izquierda.

Licencia

MIT