インストール
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" を実行。テレビが無いと公式はブラウザで開くと言う。読み取り専用ではない。作品名を解決し content ID を得てアプリへディープリンクする。今の画面を占有してよいか先に確認。MCP 接続後もこの名前再生だけを繰り返し、他ツール名を作ってはいけない。
成功の合図：ブラウザまたはテレビがその作品を再生し始めるか、まだ setup していないと明示する。公式は結果をキャッシュすると書くので、繰り返しは速くなるはず。
利用ケース
ケース1：テレビ無しで stv play に公式サンプル Frieren を付け、解決とディープリンクを見る。公式は No TV? Opens in your browser と書く。確認できるのはブラウザが対応内容を開くか。根拠は play の他スイッチを書いていない。欠けた部分を作ってはいけない。
ケース2：テレビがあるなら先に stv setup で接続し、名前で再生。公式は名前を言うと stv が content ID に解決しテレビ上のアプリへディープリンクすると書く。setup 済みの居間機器に合う。MCP 側は公式が 21 ツールとだけ言い、名前は出さない。ここまで確認できるのは名前再生と setup があること。URL 投写とマルチルーム音声は触れられるがコマンドは無い。そこからサブコマンドを作ってはいけない。
利用上の境界
再生はテレビまたはブラウザの状態を変える。ゼロリスクではない。公式は鍵無し・クラウド非依存と書くが、なお本機で作品名を解決しディープリンクする。画面非接触とは読めない。setup 前の実機制御範囲は書いていない。
21 の MCP ツールに名簿は無い。キャッシュで繰り返しは速くなるが、キャッシュディレクトリも掃除コマンドも無い。この説明が覆うのは pip 導入、uvx MCP 設定、stv play と stv setup だけ。コマンドの無い居間能力は外へ広げてはいけない。