mcp-vods
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-vods search for 'Inception' and play on living room TV"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
📺 MCP Server for Binge-watch
一个用于追剧/追番的MCP服务器,为AI提供搜索影视播放地址的能力,并支持在小米电视上直接播放。
📲 安装
方式1: uvx
{
"mcpServers": {
"vods": {
"command": "uvx",
"args": ["mcp-vods"],
"env": {
"MITV_LIST_CFG": "客厅电视:192.168.1.11"
}
}
}
}方式2: Docker
mkdir /opt/mcp-vods
cd /opt/mcp-vods
wget https://raw.githubusercontent.com/aahl/mcp-vods/refs/heads/main/docker-compose.yml
docker-compose up -d{
"mcpServers": {
"vods": {
"url": "http://0.0.0.0:8821/mcp" # Streamable HTTP
}
}
}方式3: Home Assistant OS Add-on
快速开始
添加到 Claude Code, 执行命令:
claude mcp add vods -- uvx mcp-vodsclaude mcp add vods --env MITV_LIST_CFG=客厅电视:192.168.1.11 -- uvx mcp-vods
添加到 OpenAI CodeX, 执行命令:
codex mcp add vods -- uvx mcp-vods添加到 Cursor
添加到 VS Code
添加到 Cherry Studio
🎓 Agent Skills
npx skills add aahl/skills --skill mcp-vods⚙️ 环境变量
免配置开箱即用
VOD_CONFIG_URL: LunaTV/MoonTV订阅源远程配置文件URL,可选(默认已内置)SEARCH_CACHE_TTL: 搜索缓存TTL,可选(默认5分钟)MAX_SEARCH_SITES: 单次最多搜索站点数,可选(默认10)
使用已部署的LunaTV/MoonTV
MOON_BASE_URL: 已部署的MoonTV服务地址,可选,如:http://0.0.0.0:3000LUNA_BASE_URL: 已部署的LunaTV服务地址,可选LUNA_USERNAME: LunaTV 登录账号,可选LUNA_PASSWORD: LunaTV 登录密码,可选
小米电视/投影/机顶盒
如需在小米电视上播放视频,要至少配置
MITV_LOCAL_IP或MITV_LIST_CFG之一
MITV_LOCAL_IP: 单台小米电视本地IP,可选MITV_LIST_CFG: 多台小米电视配置,可选,如:客厅电视:192.168.1.11;主卧电视:192.168.1.12
其他安卓电视/投影/机顶盒
如需在非小米安卓电视上播放视频,需要安装TvBox,并至少配置
TVBOX_LOCAL_IP或TVBOX_LIST_CFG之一
TVBOX_LOCAL_IP: 单台电视本地IP,可选TVBOX_LIST_CFG: 多台电视配置,可选,如:客厅电视:192.168.1.11;主卧电视:192.168.1.12
Related MCP server: TVWizard
🔗 Links
Available Tools
2 toolsvods_detail影视详情A
获取电影、电视剧、综艺节目、动漫、番剧、短剧等节目的详情及播放地址
Inputs: id (required), source (required), episode.
vods_search搜索影视A
搜索电影、电视剧、综艺节目、动漫、番剧、短剧等。如果超时可多重试几次。 当用户说以下内容时可通过本工具搜索资源:
我想看《仙逆》最新一集
凡人修仙传更新到多少集了
Inputs: keyword (required), page.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
Each tool has a distinct purpose: vods_search for searching content and vods_detail for retrieving details and play URLs. No functional overlap.
Both tools follow a consistent snake_case pattern with 'vods_' prefix and a clear verb (search/detail).
With only 2 tools, the server is minimal but covers the core needs of searching and retrieving details for VOD content. Slightly under-scoped but reasonable.
The set covers basic search and detail retrieval, which handles most user requests. Missing features like categories or recommendations are minor gaps.
Maintenance
Related MCP Connectors
Control Android TV from any AI. 38 MCP tools: playback, recap, recommend, smart-home, schedules.
Give your AI agent the power to cast to your home TV and control an interactive canvas. By ArdaBot.
Search YouTube videos, read transcripts and get public video information in your AI assistant.
Track the TV and films you watch, and find more like them, by talking to your own AI.
Related MCP Servers
- AlicenseBqualityAmaintenanceControl any smart TV with natural language — play Netflix/YouTube/Spotify by name, cast URLs, scene presets, multi-room audio, and multi-TV sync. Supports LG, Samsung, Android TV, Roku.2372 PyPI58MIT
- FlicenseNot gradedqualityDmaintenanceTurns any Claude-compatible AI chat into a universal remote for Android TV and Google TV via a cloud relay, enabling natural language control of your TV from anywhere.-
- FlicenseBqualityDmaintenanceEnables discovery and control of smart appliances (TVs, media devices) on the local network through natural language, supporting providers like Roku, Google TV, and Home Assistant.18-
- AlicenseNot gradedqualityCmaintenanceGives AI coding agents eyes and hands on a TV: capture the screen as an image, press remote keys, type text, read console logs and JS errors, deploy projects, launch apps, and apply or revert system tweaks across Android TV, Google TV, Fire TV, Roku and LG webOS. This lets an agent design, live-check and iterate on a custom ad-free home screen directly on the big screen.2MIT