MCP 가족 키오스크 디스플레이

LLM이 MCP 도구 호출을 통해 제어할 수 있는 세련된 애니메이션 키오스크 디스플레이입니다.

제공 기능

• 키오스크 제어 도구가 포함된 stdio 기반 MCP 서버

• http://localhost:8787에서 제공되는 HTTP 키오스크 디스플레이 엔드포인트

• WebSocket을 통한 실시간 업데이트 (/ws)

• 가독성이 높은 큰 타이포그래피와 부드러운 애니메이션 전환

• 텍스트, 이미지, 비디오 등 혼합 장면 요소 지원

• 긴급한 가족 업데이트를 위한 오버레이 공지사항

• 무인 디스플레이 회전을 위한 자동 재생 목록 모드

Related MCP server: openai-mcp

MCP 통합

이 서버는 두 가지 MCP 전송 방식을 지원합니다:

1. Stdio (기본값) — stdio 기반 MCP를 사용하는 LLM 클라이언트용

2. HTTP 스트리밍 — n8n, Zapier 또는 사용자 지정 통합 도구용

Stdio 전송

표준 stdin/stdout 기반 MCP입니다. 대부분의 LLM 클라이언트에서 하위 프로세스로 사용됩니다.

HTTP 스트리밍 전송

n8n 또는 모든 HTTP 클라이언트에서 MCP 도구를 호출합니다.

• GET /mcp/tools — 사용 가능한 모든 도구 목록 조회

• POST /mcp/call — 도구 호출 (JSON 응답)

• POST /mcp/stream — 도구 호출 (Server-Sent Events 응답)

예시: n8n에서 /mcp/call로 보내는 HTTP POST 요청

{
  "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 호스트 구성에 대한 참조로 mcp.client.example.json을 사용하세요.

사용자 지정 아이디어

• Home Assistant에서 가족 달력 데이터를 가져오기

• 날씨 및 대중교통 카드를 텍스트 요소로 추가

• 집안일 게시판 및 반복 알림 표시

• theme 및 장면 미디어를 전환하여 명절 테마 구성

참고 사항

• 미디어 URL은 키오스크 브라우저에서 공개적으로 액세스할 수 있어야 합니다.

• 로컬/개인 미디어의 경우 public/ 폴더에서 파일을 제공하고 상대 경로를 참조하세요.