mcp-vods

關於 mcp-vods

一個面向智慧體的橋樑，用於查詢和播放流媒體影片，涵蓋多個源站點的電影、電視劇、動漫、短劇和綜藝節目，並支援可選的電視投屏功能。它透過 mcporter 連線到 mcp-vods MCP 伺服器，呼叫方式為 npx -y mcporter 以獲得更好的相容性，並提供一組用於搜尋和播放的工具，使智慧體能夠幫助使用者追蹤劇集並繼續觀看系列內容。

搜尋功能使用 vods_search 工具，傳入關鍵詞和可選的頁碼。由於它同時查詢多個源站點，速度可能較慢，因此文件建議設定充足的超時時間並在失敗時重試。完整的工具模式可以透過 mcporter list --schema --all-parameters 檢視。支援兩種投屏路徑。mitv_play_media 將媒體 URL 投屏到小米電視，需要配置 MITV_LOCAL_IP 或 MITV_LIST_CFG 環境變數。tvbox_play_media 投屏到安卓電視，需要配置 TVBOX_LOCAL_IP 或 TVBOX_LIST_CFG，並且電視上已安裝 TvBox 應用。

內建了一個實用的注意事項：部分源站點返回的是網頁 URL 而非直接的媒體連結（不含 .m3u8 或 .mp4），此類連結無法直接投屏或播放。在這種情況下，建議使用 curl -sSL 獲取該網頁以解析出真實的播放地址。整體設計保持介面精簡，搜尋功能返回播放候選項，播放工具則將解析後的 URL 及電視地址傳遞給相應的投屏後端，使其非常適合在小米或安卓電視上跨會話持續追劇。

常見問題解答

它可以搜尋哪些型別的內容？

涵蓋多個源站點的電影、電視劇、動漫、短劇和綜藝節目，包括檢查正在更新劇集的進度。

它如何連線到 mcp-vods 伺服器？

透過 mcporter 連線，執行命令為 npx -y mcporter call --stdio 'uvx mcp-vods' ...，使用 npx 而非全域性安裝的 mcporter 以獲得更好的相容性。

投屏到小米電視需要什麼條件？

必須配置 MITV_LOCAL_IP 或 MITV_LIST_CFG 環境變數，然後使用 mitv_play_media 工具將媒體 URL 投屏至電視的 IP 地址。

它支援安卓電視播放嗎？

支援，透過 tvbox_play_media 實現，需要配置 TVBOX_LOCAL_IP 或 TVBOX_LIST_CFG，並且電視上已安裝 TvBox 應用。

如果返回的連結是網頁而非媒體檔案怎麼辦？

部分源站點返回的是不含 .m3u8 或 .mp4 的頁面 URL，無法直接投屏。建議對該 URL 執行 curl -sSL 以解析出真實的播放地址。