MCP 家庭信息亭显示

一个精致的动画信息亭显示系统，可通过 MCP 工具调用由 LLM 进行控制。

功能特点

• 基于 stdio 的 MCP 服务器，提供信息亭控制工具

• HTTP 信息亭显示端点：http://localhost:8787

• 通过 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 — 调用工具（服务器发送事件响应）

示例：n8n HTTP POST 到 /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)

• 显示 Web 服务器 (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/ 目录提供文件并引用相对路径。