What is SmartScreen?

SmartScreen is a web-based screening service that allows you to remotely control content across multiple displays and locations.

What is ultra/mcp-ss?

ultra/mcp-ss is a FastAPI-based MCP server that integrates with SmartScreen, allowing you to programmatically control the screen (e.g., display media, send notifications) via HTTP/MCP commands.

What prerequisites are required to run ultra/mcp-ss?

You need Python 3.12+, Docker (optional), a YOUTUBE_API_KEY from Google Console, and an SS_SERVICE_TOKEN environment variable.

How do I configure ultra/mcp-ss?

Create a .env file or export environment variables for YOUTUBE_API_KEY and SS_SERVICE_TOKEN.

How do I run ultra/mcp-ss locally?

Run uvicorn main:app --reload --host 0.0.0.0 --port 8000 in your terminal.

How do I run ultra/mcp-ss with Docker?

Build the Docker image with docker build -t ultra-mcp-ss . and run it with docker run -d --name ultra-mcp-ss -p 127.0.0.1:8000:8000 ultra-mcp-ss.

What are the key API endpoints?

Key endpoints include /drop, /notify, /toast, /marquee, /text, /app, /touch, and /status for controlling SmartScreen functions. Refer to the OpenAPI docs for details.

How do I integrate ultra/mcp-ss with Langflow?

Add the MCP Server component from the Tool section in Langflow, enable Tool Mode, select SSE Mode, and enter the MCP SSE URL (e.g., http://0.0.0.0:8000/mcp).

What is MCP Proxy and when should I use it?

MCP Proxy is used for clients without SSE support. Install it via uv pip install --user mcp-proxy or npm install -g mcp-proxy and configure your client to use it as a proxy to the MCP server.

How does ultra/mcp-ss integrate with UBOS?

UBOS can orchestrate AI Agents to interact with ultra/mcp-ss, enabling dynamic control of SmartScreen displays based on real-time data and user interactions. UBOS allows building custom AI Agents tailored to specific needs and integrates seamlessly with ultra/mcp-ss through MCP.