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

目录

• 什么是 SmartScreen？

• 先决条件

• 配置

• 本地运行

• Docker

• API 端点

  • 健康与搜索

  • SmartScreen 命令 (HTTP)

• MCP 工具集成

• 在不支持 SSE 的客户端上使用 MCP 代理

• 在 Langflow 中设置 MCP-SS

• 贡献

Related MCP server: Computer Control MCP

什么是 SmartScreen？

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

SmartScreen 设置：

1. 通过 URL 访问 SmartScreen：smartscreen.tv
   

   • 在 Linux 上，可以通过 snapcraft 安装 SmartScreen。

2. 点击左上角的菜单按钮进入**“设置”** 。在这里，您可以命名设备、添加标签，以及设置 OnStart 和其他预定事件。
   

   • 进行任何更改后，请不要忘记单击“保存”。

3. 单击SmartScreen返回主页。

超/mcp-ss

先决条件

• Python 3.12+

• Docker（可选，用于容器化部署）

• 通过 Google Console 为“YouTube Data API v3”设置 YOUTUBE_API_KEY

• 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

docker build -t ultra-mcp-ss .
docker run -d --name ultra-mcp-ss -p 127.0.0.1:8000:8000 ultra-mcp-ss

API 端点

基本网址： http://127.0.0.1:8000 8000

健康与搜索

• HEAD /mcp – MCP 的健康检查

• GET /search-youtube?query=... – 返回最相关的 YouTube 视频 URL

SmartScreen 命令 (HTTP)

有关请求/响应模式，请参阅http://<host>:8000/docs上的 OpenAPI 文档。

MCP 工具集成

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

在不支持 SSE 的客户端上使用 MCP 代理 (Claude Desktop)

1. 安装 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. 在 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"]
       }
     }
   }

在 Langflow 中设置 MCP-SS

要将 ultra-mcp-ss 与 Langflow 集成：

1. 从 Langflow 的工具部分添加 MCP 服务器组件

2. 在组件设置中启用工具模式

3. 选择 SSE 模式进行实时通信

4. 输入 MCP SSE URL： http://0.0.0.0:8000/mcp 8000/mcp

5. 如果使用Docker运行，请使用http://127.0.0.1:8000 。

6. 运行组件建立连接

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

贡献

1. 复制仓库

2. 创建功能分支

3. 提交拉取请求

使用 FastAPI 和 FastApiMCP 制作