MCP Familien-Kiosk-Display

Ein ausgefeiltes, animiertes Kiosk-Display, das von einem LLM über MCP-Tool-Aufrufe gesteuert werden kann.

Was dies bietet

• MCP-Server über Stdio mit Kiosk-Steuerungstools

• HTTP-Kiosk-Display-Endpunkt unter http://localhost:8787

• Echtzeit-Updates über WebSocket (/ws)

• Große, lesbare Typografie und flüssige animierte Übergänge

• Unterstützung für gemischte Szenenelemente: Text, Bilder und Videos

• Overlay-Ankündigungen für dringende Familien-Updates

• Playlist-Modus mit automatischem Weiterblättern für unbeaufsichtigte Display-Rotation

Related MCP server: openai-mcp

MCP-Integrationen

Der Server unterstützt zwei MCP-Transporte:

1. Stdio (Standard) — für LLM-Clients, die Stdio-basiertes MCP verwenden

2. HTTP-Streaming — für Tools wie n8n, Zapier oder benutzerdefinierte Integrationen

Stdio-Transport

Standard-MCP über Stdin/Stdout. Wird von den meisten LLM-Clients als Subprozess verwendet.

HTTP-Streaming-Transport

Aufruf von MCP-Tools aus n8n oder einem beliebigen HTTP-Client.

• GET /mcp/tools — alle verfügbaren Tools auflisten

• POST /mcp/call — ein Tool aufrufen (JSON-Antwort)

• POST /mcp/stream — ein Tool aufrufen (Server-Sent Events-Antwort)

Beispiel: n8n HTTP POST an /mcp/call

{
  "tool": "kiosk_show_chores",
  "arguments": {
    "dueToday": ["Dishes", "Homework", "Vacuum living room"],
    "done": ["Breakfast prep", "Make beds"],
    "points": ["Jane: 12 pts", "Max: 8 pts"],
    "theme": "party"
  }
}

Antwort:

{
  "ok": true,
  "message": "Chore dashboard rendered",
  "state": { /* full kiosk state */ }
}

Lokal ausführen

1. Abhängigkeiten installieren

2. Server starten

3. Kiosk-Display im Browser öffnen

Der Serverprozess hostet beides:

• MCP-Tool-Schnittstelle (Stdio)

• Display-Webserver (http://localhost:8787)

Beispiel-Szenen-Payload für kiosk_set_playlist

Verwenden Sie diese Form von Ihrem LLM-Client:

• title, subtitle

• theme: aurora | sunrise | ocean | midnight | party

• transition: slide | fade | zoom

• autoAdvance, autoAdvanceSec

• scenes[]

  • title, subtitle, accent, durationSec

  • elements[]

    • type: text mit heading, body

    • type: image mit url, optional caption

    • type: video mit url, optional caption und den Booleans muted, autoplay, loop

High-Level-Familien-Workflow-Tools

Für die meisten Home-Assistant-Anwendungsfälle sollten Sie diese Tools anstelle von rohem Playlist-JSON bevorzugen:

• kiosk_show_calendar

  • Eingaben: dayLabel, events[], now, next, highlight

  • events[] akzeptiert entweder einfache Strings oder Objekte mit when, time, label

• kiosk_show_chores

  • Eingaben: dueToday[], done[], points[]

• kiosk_show_meal_plan

  • Eingaben: breakfast, lunch, dinner, prep[], shopping[]

• kiosk_show_school_run

  • Eingaben: leaveBy, weather, checklist[], reminders[]

• kiosk_announce

  • Eingaben: message (erforderlich), details[], emoji, showOverlay

Jedes der oben genannten Tools unterstützt auch optionale visuelle Steuerelemente:

• title, subtitle

• theme: aurora | sunrise | ocean | midnight | party

• transition: slide | fade | zoom

• autoAdvance, autoAdvanceSec

MCP-Client-Verkabelung

Verwenden Sie mcp.client.example.json als Referenz für Ihre MCP-Host-Konfiguration.

Anpassungsideen

• Familienkalenderdaten aus Home Assistant einbinden

• Wetter- und Transit-Karten als Textelemente hinzufügen

• Aufgaben-Boards und rotierende Erinnerungen anzeigen

• Feiertags-Themen durch Wechseln von theme und Szenenmedien erstellen

Hinweise

• Stellen Sie sicher, dass Medien-URLs für den Kiosk-Browser öffentlich zugänglich sind.

• Für lokale/private Medien: Stellen Sie Dateien aus public/ bereit und referenzieren Sie relative Pfade.