安裝
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;其它客廳能力若不帶命令,就不要外推。