Ultra MCP SS

Un servidor MCP para el control programático de pantallas smartscreen.tv mediante comandos HTTP y MCP, con integración de YouTube.

GitHub
1
Prueba este MCPPatrocinado

Documentación

ultra-mcp-ss (lab)

Adaptador MCP de SmartScreen para clientes MCP externos.

Ubicación del laboratorio: u22, expuesto como https://ultra-mcp.u22.ypcloud.com/mcp/ss.

Puntos de conexión

  • POST /mcp/ss: punto de conexión estándar MCP Streamable HTTP JSON-RPC.
  • GET /mcp/ss: flujo de eventos opcional del servidor Streamable HTTP.
  • GET /sse/ss: transporte MCP SSE heredado cuando MCP_TRANSPORT=http+sse.
  • POST /api/ss: entrada HTTP nativa de {to,data} para diagnósticos; la entrega posterior sigue usando solo MoteBus.
  • GET /ping: salud del proceso.

Cada operación de SmartScreen utiliza esta ruta posterior:

  • Leer ultra_ss_app_lab_mma de u22/comm/comm-app en map://ultra-map-dev.
  • Validar la fuente seleccionada de ultra-map y el propietario resuelto de u22/ss/ss-srv-app.
  • Enviar el comando de pantalla nativo de {to,data} a través de MoteBus xmsg en ss://mms. No agregue marcadores de transporte reservados al cuerpo del comando.
  • Fallar visiblemente si la resolución del mapa, MoteChat, el propietario o su respuesta no están disponibles. No hay respaldo HTTP ni de transporte alternativo.

Un cliente MCP debe inicializar la sesión antes de listar o llamar herramientas. Para Hermes, registre la URL pública de MCP, recargue el descubrimiento de MCP y espere herramientas como ss_notify, ss_drop, ss_go y ss_text. ss_go es la forma MCP de primera clase de /ss go <qname-or-page-route>; por ejemplo, 101.tv despacha la ruta nativa de WebOS page://board?type=dock&q=101.tv. La herramienta restringida ss_command permite que la habilidad canónica SS transporte datos de comando nativos propiedad de SS a través de una solicitud MCP estándar tools/call; no cambia la ruta posterior exclusiva de MoteBus.

La protección contra reenlace de DNS permanece habilitada. La configuración de Compose del laboratorio permite solo el nombre de host público del laboratorio más los nombres locales/contenedores. PD permite de forma independiente mcp-ss.ypcloud.com y la puerta de enlace compartida ultra-mcp.ypcloud.com; los alias de PD y del laboratorio no son intercambiables.

La identidad de inicio de MoteChat y la configuración de la puerta de enlace se mantienen solo en el contrato de topología bloqueado ultra-mcp-ss-mchat.env. El nivel UltraMap seleccionado se declara por separado mediante Compose a través de ULTRA_MCP_SS_MAP_TIER.