mcp-vods

mcp-vods 소개

영화, TV 시리즈, 애니메이션, 단막극, 버라이어티 쇼 등 여러 소스 사이트에서 스트리밍 비디오를 찾고 재생하기 위한 에이전트용 브리지로, TV로의 옵션 캐스팅을 지원합니다. mcporter를 통해 mcp-vods MCP 서버에 연결되며, 호환성을 위해 npx -y mcporter로 호출됩니다. 검색 및 재생을 위한 소수의 도구를 노출하여 에이전트가 사용자가 시리즈를 추적하고 계속 시청할 수 있도록 도와줍니다.

검색은 키워드와 선택적 페이지 번호를 사용하는 vods_search 도구를 통해 수행됩니다. 여러 소스 사이트에 동시에 쿼리하므로 느릴 수 있으며, 문서에서는 관대한 타임아웃을 허용하고 실패 시 재시도할 것을 권장합니다. 전체 도구 스키마는 mcporter list --schema --all-parameters로 확인할 수 있습니다. 두 가지 캐스팅 경로가 지원됩니다. mitv_play_media는 미디어 URL을 샤오미 TV로 캐스팅하며 MITV_LOCAL_IP 또는 MITV_LIST_CFG 환경 변수가 필요합니다. tvbox_play_media는 안드로이드 TV로 캐스팅하며 TVBOX_LOCAL_IP 또는 TVBOX_LIST_CFG와 TV에 설치된 TvBox 앱이 필요합니다.

실용적인 주의 사항이 내장되어 있습니다. 일부 소스 사이트는 직접적인 미디어 링크(.m3u8 또는 .mp4 없음)가 아닌 웹 페이지 URL을 반환하며, 이는 그대로 캐스팅하거나 재생할 수 없습니다. 이러한 경우 curl -sSL을 사용하여 페이지를 가져와 실제 재생 주소를 확인하는 것이 권장됩니다. 전체 설계는 인터페이스를 얇게 유지하며, 검색은 재생 후보를 반환하고 재생 도구는 해결된 URL과 TV 주소를 적절한 캐스팅 백엔드에 전달하여 샤오미 또는 안드로이드 TV에서 세션 간에 에피소드를 추적하는 데 적합합니다.

FAQ

어떤 종류의 콘텐츠를 검색할 수 있나요?

영화, TV 시리즈, 애니메이션, 단막극, 버라이어티 쇼 등 여러 소스 사이트에서 검색 가능하며, 진행 중인 쇼의 업데이트 진행 상황을 확인할 수 있습니다.

mcp-vods 서버에 어떻게 연결하나요?

mcporter를 통해 연결하며, npx -y mcporter call --stdio 'uvx mcp-vods' ...로 실행합니다. 전역 mcporter 대신 npx를 사용하여 호환성을 높입니다.

샤오미 TV로 캐스팅하려면 무엇이 필요하나요?

MITV_LOCAL_IP 또는 MITV_LIST_CFG 환경 변수가 구성되어야 하며, 그런 다음 mitv_play_media 도구를 사용하여 미디어 URL을 TV의 IP 주소로 캐스팅합니다.

안드로이드 TV 재생을 지원하나요?

네, tvbox_play_media를 통해 지원하며, TVBOX_LOCAL_IP 또는 TVBOX_LIST_CFG가 구성되고 TV에 TvBox 앱이 설치되어 있어야 합니다.

반환된 링크가 미디어 파일이 아닌 웹 페이지인 경우 어떻게 하나요?

일부 소스는 직접 캐스팅할 수 없는 .m3u8 또는 .mp4 없이 페이지 URL을 반환합니다. 실제 재생 주소를 확인하기 위해 URL에 curl -sSL을 실행하는 것이 권장됩니다.