Integrations
ultra/mcp-ss is a FastAPI-based MCP server that integrates with smartscreen.tv, a web display service, allowing you to programmatically manipulate the screen (e.g., display media, send notifications, control playback) via simple HTTP/MCP commands.
Table of Contents
- What is SmartScreen?
- Prerequisites
- Configuration
- Running Locally
- Docker
- API Endpoints
- MCP Tool Integration
- Using MCP Proxy for Clients Without SSE Support
- Setting up MCP-SS in Langflow
- Contributing
What is SmartScreen?
SmartScreen is a web-based screening service.
Content across multiple displays and locations can be controlled remotely. Simply add the MCP tool to your AI app.
SmartScreen setup:
- Access SmartScreen through URL: smartscreen.tv
- On Linux, SmartScreen can be installed via snapcraft.
- Click the menu button on the top-left corner to reach
Settings. Here you can name your device, add tags, and set up OnStart and other scheduled events.
- Don’t forget to click “Save” after making any changes.
- Click SmartScreen to return to the Home Page.
ultra/mcp-ss
Prerequisites
- Python 3.12+
- Docker (optional, for containerized deployment)
- YOUTUBE_API_KEY set up from Google Console for "YouTube Data API v3"
- SS_SERVICE_TOKEN environment variable
Configuration
Create a .env
file or export environment variables:
- YOUTUBE_API_KEY – your Google YouTube Data API v3 key
- SS_SERVICE_TOKEN – SmartScreen service token
Example .env
:
or export them:
Running Locally
Docker
API Endpoints
Base URL: http://127.0.0.1:8000
Health & Search
HEAD /mcp
– health check for MCPGET /search-youtube?query=...
– returns the most relevant YouTube video URL
SmartScreen Commands (HTTP)
Endpoint | Description |
---|---|
POST /drop | Drop media URL onto a screen frame |
POST /notify | Send a notification banner |
POST /toast | Show a toast popup message |
POST /marquee | Display scrolling marquee text |
POST /text | Render static text overlay |
POST /app | Launch a web app in a frame |
POST /touch | Send playback/control commands |
POST /status | Query or set system status |
POST /dj | Execute DJ tasks: scheduling, kiosk, restart, logo |
Refer to OpenAPI docs at http://<host>:8000/docs
for request/response schemas.
MCP Tool Integration
FastApiMCP automatically mounts all endpoints as MCP tools under /mcp
.
Use your MCP client to invoke tools by name (e.g., drop
, notify
, toast
, etc.).
Using MCP Proxy for Clients Without SSE Support (Claude Desktop)
- Install mcp-proxy:Copy
- On Windows:
Editclaude_desktop_config.json
:Copy - On MacOS:
Get the path tomcp-proxy
:EditCopyclaude_desktop_config.json
:Copy
Setting up MCP-SS in Langflow
To integrate ultra-mcp-ss with Langflow:
- Add MCP Server component from the Tool section in Langflow
- Enable Tool Mode in the component settings
- Select SSE Mode for real-time communication
- Enter the MCP SSE URL:
http://0.0.0.0:8000/mcp
- Use
http://127.0.0.1:8000
if running using Docker. - Run the component to establish connection
Once connected, you can use all SmartScreen commands within your Langflow workflows.
Contributing
- Fork the repo
- Create a feature branch
- Submit a pull request
Made with FastAPI & FastApiMCP
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A FastAPI-based MCP server that integrates with smartscreen.tv, allowing you to programmatically control web displays by displaying media, sending notifications, and controlling playback via HTTP commands.
Related MCP Servers
- AsecurityAlicenseAqualityA powerful MCP server for fetching and transforming web content into various formats (HTML, JSON, Markdown, Plain Text) with ease.Last updated -414612TypeScriptMIT License
- AsecurityAlicenseAqualityAn MCP server that provides tools for interacting with Chrome through its DevTools Protocol, enabling remote control of Chrome tabs to execute JavaScript, capture screenshots, monitor network traffic, and more.Last updated -73014TypeScriptMIT License
- -securityAlicense-qualityA MCP server that provides browser automation tools, allowing users to navigate websites, take screenshots, click elements, fill forms, and execute JavaScript through Playwright.Last updated -PythonApache 2.0
- -securityAlicense-qualityA browser automation server providing Playwright capabilities for controlling web browsers, capturing screenshots, extracting content, and performing complex interactions through an MCP interface.Last updated -PythonApache 2.0