Ultra MCP SS

ultra-mcp-ss (lab)

Adaptador MCP SmartScreen para clientes MCP externos.

Posicionamento no lab: u22, exposto como https://ultra-mcp.u22.ypcloud.com/mcp/ss.

Endpoints

• POST /mcp/ss: endpoint padrão MCP Streamable HTTP JSON-RPC.
• GET /mcp/ss: fluxo de eventos opcional do servidor Streamable HTTP.
• GET /sse/ss: transporte MCP SSE legado quando MCP_TRANSPORT=http+sse.
• POST /api/ss: entrada HTTP nativa {to,data} para diagnósticos; a entrega downstream ainda usa apenas MoteBus.
• GET /ping: saúde do processo.

Cada operação SmartScreen usa esta rota downstream:

• Ler ultra_ss_app_lab_mma de u22/comm/comm-app em map://ultra-map-dev.
• Validar a fonte ultra-map selecionada e o proprietário u22/ss/ss-srv-app resolvido.
• Enviar o comando de tela nativo {to,data} via MoteBus xmsg em ss://mms. Não adicione marcadores de transporte reservados ao corpo do comando.
• Falhar visivelmente se a resolução de mapa, MoteChat, o proprietário ou sua resposta estiverem indisponíveis. Não há fallback HTTP ou de transporte alternativo.

Um cliente MCP deve inicializar a sessão antes de listar ou chamar ferramentas. Para Hermes, registre a URL MCP pública, recarregue a descoberta MCP e espere ferramentas como ss_notify, ss_drop, ss_go e ss_text. ss_go é a forma MCP de primeira classe de /ss go <qname-or-page-route>; por exemplo, 101.tv despacha a rota WebOS nativa page://board?type=dock&q=101.tv. A ferramenta restrita ss_command permite que a habilidade SS canônica carregue dados de comando nativos de propriedade da SS através de uma solicitação MCP tools/call padrão; isso não altera a rota downstream exclusiva do MoteBus.

A proteção contra rebinding de DNS permanece habilitada. A configuração do Lab Compose permite apenas o hostname público do Lab mais nomes locais/contêineres. O PD independentemente permite mcp-ss.ypcloud.com e o gateway compartilhado ultra-mcp.ypcloud.com; os aliases do PD e do Lab não são intercambiáveis.

A identidade de inicialização do MoteChat e as configurações de gateway são mantidas apenas no contrato de topologia ultra-mcp-ss-mchat.env bloqueado. O nível UltraMap selecionado é declarado separadamente pelo Compose através de ULTRA_MCP_SS_MAP_TIER.