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 以解析出真实的播放地址。