Дисплей семейного киоска MCP

Эффектный анимированный дисплей киоска, которым можно управлять с помощью LLM через вызовы инструментов MCP.

Что это дает

• MCP-сервер через stdio с инструментами управления киоском

• HTTP-эндпоинт дисплея киоска по адресу http://localhost:8787

• Обновления в реальном времени через WebSocket (/ws)

• Крупная читабельная типографика и плавные анимированные переходы

• Поддержка смешанных элементов сцены: текст, изображения и видео

• Накладываемые объявления для срочных семейных уведомлений

• Режим плейлиста с автоматической сменой для автономной ротации дисплея

Related MCP server: openai-mcp

Интеграции MCP

Сервер поддерживает два транспорта MCP:

1. Stdio (по умолчанию) — для LLM-клиентов, использующих MCP на основе stdio

2. HTTP streaming — для таких инструментов, как n8n, Zapier или пользовательских интеграций

Транспорт Stdio

Стандартный MCP через stdin/stdout. Используется большинством LLM-клиентов в качестве подпроцесса.

Транспорт HTTP streaming

Вызывайте инструменты MCP из n8n или любого HTTP-клиента.

• GET /mcp/tools — список всех доступных инструментов

• POST /mcp/call — вызов инструмента (JSON-ответ)

• POST /mcp/stream — вызов инструмента (ответ Server-Sent Events)

Пример: HTTP POST в n8n для /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"
  }
}

Ответ:

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

Запуск локально

1. Установите зависимости

2. Запустите сервер

3. Откройте дисплей киоска в браузере

Процесс сервера размещает оба компонента:

• Интерфейс инструментов MCP (stdio)

• Веб-сервер дисплея (http://localhost:8787)

Пример полезной нагрузки сцены для kiosk_set_playlist

Используйте эту структуру в своем LLM-клиенте:

• title, subtitle

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

• transition: slide | fade | zoom

• autoAdvance, autoAdvanceSec

• scenes[]

  • title, subtitle, accent, durationSec

  • elements[]

    • type: text с heading, body

    • type: image с url, опционально caption

    • type: video с url, опционально caption, и логическими значениями muted, autoplay, loop

Высокоуровневые инструменты для семейных задач

Для большинства сценариев использования в умном доме отдавайте предпочтение этим инструментам, а не «сырому» JSON плейлиста:

• kiosk_show_calendar

  • Входные данные: dayLabel, events[], now, next, highlight

  • events[] принимает либо простые строки, либо объекты с when, time, label

• kiosk_show_chores

  • Входные данные: dueToday[], done[], points[]

• kiosk_show_meal_plan

  • Входные данные: breakfast, lunch, dinner, prep[], shopping[]

• kiosk_show_school_run

  • Входные данные: leaveBy, weather, checklist[], reminders[]

• kiosk_announce

  • Входные данные: message (обязательно), details[], emoji, showOverlay

Каждый из инструментов выше также поддерживает опциональные визуальные элементы управления:

• title, subtitle

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

• transition: slide | fade | zoom

• autoAdvance, autoAdvanceSec

Настройка клиента MCP

Используйте mcp.client.example.json в качестве справочника для конфигурации вашего хоста MCP.

Идеи для кастомизации

• Передавайте данные семейного календаря из Home Assistant

• Добавьте карточки погоды и транспорта в виде текстовых элементов

• Отображайте доски домашних дел и периодические напоминания

• Создавайте праздничные темы, переключая theme и медиафайлы сцен

Примечания

• Убедитесь, что медиа-URL доступны для браузера киоска.

• Для локальных/приватных медиафайлов используйте папку public/ и ссылайтесь на относительные пути.