Install
pip install stv누구에게 맞나
터미널이나 에이전트에서 제목을 말하고 TV가 Netflix, Apple TV+, YouTube 또는 Spotify를 열게 하고 싶다면 이 도구가 맞다. URL을 던지고 여러 방 오디오를 하며 MCP 서버로 도우미가 방을 맡게 할 수도 있다. TV 펌웨어가 아니며 회원 가입을 대신해 주지도 않는다.
공식 설명:
https://github.com/Hybirdss/smartest-tv
가장 중요한 전제: TV 없이도 먼저 시험할 수 있고 명령은 브라우저에서 열린다. TV가 있으면 먼저 stv setup 후 연결한다. 공식은 API 키가 필요 없고 클라우드에 의존하지 않으며 브라우저 자동화가 아니라고 쓴다. 저장소 제목은 LG, Samsung, Roku, Android도 언급한다.
3분 만에 첫 시도
공식 권장 경로는 하나다. pip로 패키지 이름 stv를 설치하고 공식 예시 제목을 하나 재생한다.
전제: Python / pip가 설치되어 있다. TV는 없어도 된다. 첫 재생은 브라우저나 TV의 해당 앱을 연다. 보이는 부작용이니 현재 화면을 끊어도 되는지 확인하라.
설치 명령:
pip install stv
설정 위치: MCP 클라이언트의 mcpServers.tv에서 command는 uvx, args는 stv다. 공식이 준 한 줄 MCP 표기다. 근거는 Claude Code, Codex, Antigravity를 거명한다. pip는 명령줄, uvx는 MCP다. 세 번째 설치기를 더하지 마라.
위험 낮은 첫 호출: stv play "Frieren"를 실행한다. TV가 없으면 공식은 브라우저에서 연다고 한다. 읽기 전용이 아니다. 제목을 해석하고 content ID를 얻어 앱으로 딥링크한다. 현재 화면을 차지해도 되는지 먼저 확인하라. MCP를 붙인 뒤에도 이 이름 재생만 반복하고 다른 도구 이름을 만들지 마라.
성공 신호: 브라우저나 TV가 그 제목을 재생하기 시작하거나 setup이 아직 없다고 분명히 알린다. 공식은 결과를 캐시한다고 하므로 반복은 더 빨라야 한다.
사용 사례
사례 1: TV가 없을 때 stv play에 공식 예시 제목 Frieren을 붙여 해석과 딥링크를 확인한다. 공식은 No TV? Opens in your browser로 쓴다. 확인할 수 있는 것은 브라우저가 해당 내용을 여는지다. 근거는 play의 다른 스위치를 쓰지 않았으니 빠진 부분을 만들지 마라.
사례 2: TV가 있으면 먼저 stv setup으로 연결한 뒤 이름으로 재생한다. 공식은 이름을 말하면 stv가 content ID로 해석하고 TV 앱으로 딥링크한다고 한다. setup을 끝낸 거실 기기에 맞다. MCP 쪽에서 공식은 도구가 21개라고만 하고 이름을 대지 않는다. 여기까지는 이름 재생과 setup이 있다는 것만 확인할 수 있다. URL 투영과 여러 방 오디오는 언급되지만 명령이 없으니 그것으로 하위 명령을 만들지 마라.
사용 한계
재생은 TV나 브라우저 상태를 바꾸며 제로 위험이 아니다. 공식은 키 없음, 클라우드 비의존이라고 쓰지만 여전히 로컬에서 제목을 해석하고 딥링크한다. 화면을 안 만진다고 읽으면 안 된다. setup 이전 실제 기기 제어 범위는 쓰여 있지 않다.
21개 MCP 도구의 이름 명단은 없다. 캐시로 반복이 빨라지지만 캐시 디렉터리와 정리 명령은 없다. 이 설명은 pip 설치, uvx MCP 설정, stv play와 stv setup만 다룬다. 명령이 없는 다른 거실 능력은 밖으로 밀지 마라.