Ultra MCP-SS

ultra/mcp-ss es un servidor MCP basado en FastAPI que se integra con smartscreen.tv, un servicio de visualización web, que le permite manipular la pantalla mediante programación (por ejemplo, mostrar medios, enviar notificaciones, controlar la reproducción) a través de simples comandos HTTP/MCP.

Tabla de contenido

• ¿Qué es SmartScreen?
• Prerrequisitos
• Configuración
• Ejecutando localmente
• Estibador
• Puntos finales de API
  • Salud y búsqueda
  • Comandos SmartScreen (HTTP)
• Integración de herramientas MCP
• Uso del proxy MCP para clientes sin soporte SSE
• Configuración de MCP-SS en Langflow
• Contribuyendo

¿Qué es SmartScreen?

SmartScreen es un servicio de evaluación basado en la web.
El contenido en múltiples pantallas y ubicaciones se puede controlar remotamente. Simplemente agrega la herramienta MCP a tu aplicación de IA.

Configuración de SmartScreen:

1. Acceda a SmartScreen a través de la URL: smartscreen.tv
   
   • En Linux, SmartScreen se puede instalar a través de Snapcraft.
2. Haz clic en el botón de menú en la esquina superior izquierda para acceder a Configuración . Aquí puedes nombrar tu dispositivo, agregar etiquetas y configurar OnStart y otros eventos programados.
   
   • No olvide hacer clic en “Guardar” después de realizar cualquier cambio.
3. Haga clic en SmartScreen para regresar a la página de inicio.

ultra/mcp-ss

Prerrequisitos

• Python 3.12+
• Docker (opcional, para implementación en contenedores)
• YOUTUBE_API_KEY configurado desde Google Console para "YouTube Data API v3"
• Variable de entorno SS_SERVICE_TOKEN

Configuración

Cree un archivo .env o exporte variables de entorno:

• YOUTUBE_API_KEY: su clave de la API de datos de Google YouTube v3
• SS_SERVICE_TOKEN – Token de servicio SmartScreen

Ejemplo .env :

o exportarlos:

Ejecutando localmente

Estibador

Puntos finales de API

URL base: http://127.0.0.1:8000

Salud y búsqueda

• HEAD /mcp – comprobación del estado de MCP
• GET /search-youtube?query=... – devuelve la URL del video de YouTube más relevante

Comandos SmartScreen (HTTP)

Consulte la documentación de OpenAPI en http://<host>:8000/docs para conocer los esquemas de solicitud/respuesta.

Integración de herramientas MCP

FastApiMCP monta automáticamente todos los puntos finales como herramientas MCP en /mcp .
Utilice su cliente MCP para invocar herramientas por nombre (por ejemplo, drop , notify , toast , etc.).

Uso del proxy MCP para clientes sin compatibilidad con SSE (Claude Desktop)

1. Instalar mcp-proxy:
   uv pip install --user mcp-proxy #for Python npm install -g mcp-proxy #for Node.js pnpm add -g mcp-proxy #for Node.js
2. En Windows:
   Editar claude_desktop_config.json :
   { "mcpServers": { "ultra-mcp-ss": { "command": "mcp-proxy", "args": ["http://0.0.0.0:8000/mcp"] } } }
3. En MacOS:
   Obtenga la ruta a mcp-proxy :
   which mcp-proxy
   Editar claude_desktop_config.json :
   { "mcpServers": { "ultra-mcp-ss": { "command": "/YOUR/PATH/TO/mcp-proxy", "args": ["http://0.0.0.0:8000/mcp"] } } }

Configuración de MCP-SS en Langflow

Para integrar ultra-mcp-ss con Langflow:

1. Agregue el componente MCP Server desde la sección Herramientas en Langflow
2. Habilitar el modo de herramienta en la configuración del componente
3. Seleccione el modo SSE para la comunicación en tiempo real
4. Ingrese la URL SSE de MCP: http://0.0.0.0:8000/mcp
5. Utilice http://127.0.0.1:8000 si se ejecuta utilizando Docker .
6. Ejecute el componente para establecer la conexión

Una vez conectado, podrá utilizar todos los comandos SmartScreen dentro de sus flujos de trabajo de Langflow.

Contribuyendo

1. Bifurcar el repositorio
2. Crear una rama de características
3. Enviar una solicitud de extracción

Hecho con FastAPI y FastApiMCP