Pantalla de quiosco familiar MCP

Una pantalla de quiosco animada y pulida que puede ser controlada por un LLM a través de llamadas a herramientas MCP.

Qué proporciona

• Servidor MCP sobre stdio con herramientas de control de quiosco

• Punto final de visualización de quiosco HTTP en http://localhost:8787

• Actualizaciones en tiempo real a través de WebSocket (/ws)

• Tipografía grande y legible y transiciones animadas suaves

• Soporte para elementos de escena mixtos: texto, imágenes y vídeos

• Anuncios superpuestos para actualizaciones familiares urgentes

• Modo de lista de reproducción con avance automático para rotación de pantalla sin supervisión

Related MCP server: openai-mcp

Integraciones MCP

El servidor admite dos transportes MCP:

1. Stdio (predeterminado) — para clientes LLM que utilizan MCP basado en stdio

2. Streaming HTTP — para herramientas como n8n, Zapier o integraciones personalizadas

Transporte Stdio

MCP estándar sobre stdin/stdout. Utilizado por la mayoría de los clientes LLM como un subproceso.

Transporte de streaming HTTP

Llama a herramientas MCP desde n8n o cualquier cliente HTTP.

• GET /mcp/tools — listar todas las herramientas disponibles

• POST /mcp/call — invocar una herramienta (respuesta JSON)

• POST /mcp/stream — invocar una herramienta (respuesta de eventos enviados por el servidor)

Ejemplo: POST HTTP de n8n a /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"
  }
}

Respuesta:

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

Ejecutar localmente

1. Instalar dependencias

2. Iniciar el servidor

3. Abrir la pantalla del quiosco en el navegador

El proceso del servidor aloja ambos:

• Interfaz de herramientas MCP (stdio)

• Servidor web de visualización (http://localhost:8787)

Ejemplo de carga útil de escena para kiosk_set_playlist

Utiliza esta forma desde tu cliente LLM:

• title, subtitle

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

• transition: slide | fade | zoom

• autoAdvance, autoAdvanceSec

• scenes[]

  • title, subtitle, accent, durationSec

  • elements[]

    • type: text con heading, body

    • type: image con url, caption opcional

    • type: video con url, caption opcional, y booleanos muted, autoplay, loop

Herramientas de flujo de trabajo familiar de alto nivel

Para la mayoría de los casos de uso de asistente doméstico, prefiere estas herramientas sobre el JSON de lista de reproducción sin procesar:

• kiosk_show_calendar

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

  • events[] acepta cadenas simples u objetos con when, time, label

• kiosk_show_chores

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

• kiosk_show_meal_plan

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

• kiosk_show_school_run

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

• kiosk_announce

  • Entradas: message (obligatorio), details[], emoji, showOverlay

Cada una de las herramientas anteriores también admite controles visuales opcionales:

• title, subtitle

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

• transition: slide | fade | zoom

• autoAdvance, autoAdvanceSec

Configuración del cliente MCP

Utiliza mcp.client.example.json como referencia para la configuración de tu host MCP.

Ideas de personalización

• Incorporar datos del calendario familiar desde Home Assistant

• Añadir tarjetas de clima y tránsito como elementos de texto

• Mostrar tableros de tareas y recordatorios rotativos

• Crear temas festivos cambiando theme y los medios de la escena

Notas

• Mantén las URL de los medios accesibles públicamente por el navegador del quiosco.

• Para medios locales/privados, sirve los archivos desde public/ y haz referencia a rutas relativas.