ultra/mcp-ss是一个基于FastAPI的mcp服务器，与网络显示服务smartscreen.tv集成，允许您通过简单的HTTP/mcp命令以编程方式操纵屏幕（例如，显示媒体、发送通知、控制播放）。
目录
什么是SmartScreen？
SmartScreen是一种基于网络的筛查服务。\ 可以远程控制多个显示器和位置的内容。只需将MCP工具添加到您的AI应用程序中即可。
SmartScreen设置：
- 通过URL:SmartScreen.tv访问SmartScreen\
Smartscreen - 在Linux上，SmartScreen可以通过snapcraft安装。
- 点击左上角的菜单按钮即可到达
设置。在这里，您可以命名设备、添加标签、设置OnStart和其他计划事件。\ Settings - 进行任何更改后，不要忘记单击“保存”。
- 点击 SmartScreen 返回主页。
ultra/mcp不锈钢
先决条件
- Python 3.12+
- Docker（可选，用于容器化部署）
- YOUTUBE_API_KEY从Google控制台为“YOUTUBE数据API v3”设置
- SS_SERVICE_TOKEN环境变量
配置
创建一个 .env 文件或导出环境变量：
- YOUTUBE_API_KEY–您的Google YOUTUBE数据API v3密钥
- SS_SERVICE_TOKEN–SmartScreen服务令牌
示例 .env:
YOUTUBE_API_KEY=AIzaSy...
SS_SERVICE_TOKEN=xxxxx或将其导出：
export YOUTUBE_API_KEY=AIzaSy...
export SS_SERVICE_TOKEN=xxxxx本地运行
uvicorn main:app --reload --host 0.0.0.0 --port 8000码头工人
docker build -t ultra-mcp-ss .
docker run -d --name ultra-mcp-ss -p 127.0.0.1:8000:8000 ultra-mcp-ssAPI终点
基本URL: http://127.0.0.1:8000
健康与搜索
HEAD /mcp–MCP健康检查GET /search-youtube?query=...–返回最相关的YouTube视频URL
SmartScreen命令（HTTP）
| 端点 | 描述 |
|---|---|
| POST/drop | 将媒体URL拖放到屏幕框架上 |
| POST/notify | 发送通知横幅 |
| POST/吐司 | 显示吐司弹出消息 |
| POST/选框 | 显示滚动选框文本 |
| POST/text | 渲染静态文本覆盖 |
| POST/app | 在框架中启动web应用程序 |
| POST/touch | 发送播放/控制命令 |
| POST/status | 查询或设置系统状态 |
| POST/dj | 执行dj任务：日程安排、信息亭、重启、徽标 |
请参阅OpenAPI文档 http://:8000/docs 用于请求/响应模式。
MCP工具集成
FastApiMCP会自动将所有端点挂载为MCP工具 /mcp.\ 使用您的MCP客户端按名称调用工具（例如。， drop, notify, toast等等）。
为不支持SSE的客户端使用MCP代理（Claude Desktop）
- 安装mcp代理：
uv pip install --user mcp-proxy #for Python
npm install -g mcp-proxy #for Node.js
pnpm add -g mcp-proxy #for Node.js
- 在Windows上：\
编辑 claude_desktop_config.json:
{
"mcpServers": {
"ultra-mcp-ss": {
"command": "mcp-proxy",
"args": ["http://0.0.0.0:8000/mcp"]
}
}
}- 在MacOS上：\
找到通往的路 mcp-proxy:
which mcp-proxy编辑 claude_desktop_config.json:
{
"mcpServers": {
"ultra-mcp-ss": {
"command": "/YOUR/PATH/TO/mcp-proxy",
"args": ["http://0.0.0.0:8000/mcp"]
}
}
}在廊坊市建立MCP-SS
将ultra-mcp-ss与Langflow集成：
- 从Langflow的工具部分添加MCP服务器组件
- 在组件设置中启用工具模式
- 选择SSE模式进行实时通信
- 输入MCP SSE URL：
http://0.0.0.0:8000/mcp - 使用
http://127.0.0.1:8000如果使用 码头工人. - 运行组件以建立连接
连接后，您可以在Langflow工作流中使用所有SmartScreen命令。
贡献
- 分叉回购
- 创建要素分支
- 提交拉取请求
______________________________________________________________________
采用FastAPI和FastApiMCP制造