安装
pip install stv适合谁
如果你想在终端或智能体里直接报片名,让电视打开 Netflix、Apple TV+、YouTube 或 Spotify,这个工具对得上。它还能投 URL、做多房间音频,并作为 MCP 服务器给助手当管家。它不是电视固件,也不会替你办会员。
官方说明在:
https://github.com/Hybirdss/smartest-tv
最重要的前提是:没有电视也能先试,命令会改在浏览器里打开;有电视则先 stv setup 再连接。官方写明不需要 API 密钥、不依赖云,也不是浏览器自动化。仓库标题还提到 LG、Samsung、Roku 和 Android。
3 分钟完成第一次尝试
只走官方推荐的一条路:用 pip 安装包名 stv,先播一个官方示例片名。
先决条件:已安装 Python / pip。没有电视也可以。第一次播放会打开浏览器或电视上的对应应用,这是可见的副作用,先确认你愿意打断当前屏幕。
安装命令:
pip install stv
配置位置:MCP 客户端在 mcpServers.tv 里 command 为 uvx、args 为 stv。这是官方给出的一行 MCP 写法。证据点名 Claude Code、Codex、Antigravity。pip 负责命令行,uvx 负责 MCP,不要再加第三条安装器。
低风险第一次调用:执行 stv play "Frieren"。没有电视时,官方说会在浏览器打开。这不是只读:它会解析片名、得到内容 ID,并深链进应用。先确认当前屏幕可以被占用。接上 MCP 后,也只重复这条按名字播放,不要发明其它工具名。
成功信号:浏览器或电视开始播放该片名,或明确提示尚未 setup。重复播放应更快,因为官方说结果会缓存。
使用案例
案例一:没有电视时,用 stv play 加官方示例片名 Frieren,验证解析和深链。官方把它写成 No TV? Opens in your browser。你能核对的是:浏览器是否打开对应内容。证据没有写出 play 的其它开关,缺的部分不要自造。
案例二:有电视时,先 stv setup 连接,再按名字播放。官方说报一个名字,stv 会解析成内容 ID 并深链到电视上的应用。适合已经完成 setup 的客厅设备。MCP 侧官方只说有 21 个工具,但没有列出名字。走到这里为止,只能确认按名播放和 setup 存在;投 URL 与多房间音频被提到,却没有给出命令,不能据此发明子命令。
使用边界
播放会改变电视或浏览器状态,不是零风险。官方写无密钥、无云依赖,但仍会在本地解析片名并深链,不能理解成不碰屏幕。setup 之前对真机的控制范围没有写清。
21 个 MCP 工具没有出现名单。缓存让重复播放变快,但没有写出缓存目录和清理命令。本说明只覆盖 pip 安装、uvx MCP 配置、stv play 与 stv setup;其它客厅能力若不带命令,就不要外推。