AI导哈

智能屏幕控制服务器

基于FastAPI的MCP服务器，集成smartscreen.tv服务，通过HTTP/MCP命令远程控制屏幕显示内容（如媒体播放、通知发送、播放控制等）。

  • by motebus
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 motebus/ultra-mcp-ss

使用说明

ultra/mcp-ss是一个基于FastAPI的mcp服务器，与网络显示服务smartscreen.tv集成，允许您通过简单的HTTP/mcp命令以编程方式操纵屏幕（例如，显示媒体、发送通知、控制播放）。

目录

什么是SmartScreen？

SmartScreen是一种基于网络的筛查服务。
可以远程控制多个显示器和位置的内容。只需将MCP工具添加到您的AI应用程序中即可。

SmartScreen设置：

  1. 通过URL:SmartScreen.tv访问SmartScreen
  2. 点击左上角的菜单按钮即可到达 设置。在这里，您可以命名设备、添加标签、设置OnStart和其他计划事件。
  3. 点击 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-ss

API终点

基本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://<host>:8000/docs 用于请求/响应模式。

MCP工具集成

FastApiMCP会自动将所有端点挂载为MCP工具 /mcp.
使用您的MCP客户端按名称调用工具（例如。， drop, notify, toast等等）。

为不支持SSE的客户端使用MCP代理（Claude Desktop）

  1. 安装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

  2. 在Windows上：
    编辑 claude_desktop_config.json:

    {
  "mcpServers": {
    "ultra-mcp-ss": {
      "command": "mcp-proxy",
      "args": ["http://0.0.0.0:8000/mcp"]
    }
  }
}

  3. 在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集成：

  1. 从Langflow的工具部分添加MCP服务器组件
  2. 在组件设置中启用工具模式
  3. 选择SSE模式进行实时通信
  4. 输入MCP SSE URL： http://0.0.0.0:8000/mcp
  5. 使用 http://127.0.0.1:8000 如果使用 码头工人.
  6. 运行组件以建立连接

连接后，您可以在Langflow工作流中使用所有SmartScreen命令。

贡献

  1. 分叉回购
  2. 创建要素分支
  3. 提交拉取请求

采用FastAPI和FastApiMCP制造

相关 MCP