MCP Server for Binge-watch MCP Server
io.github.aahl/mcp-vods
Search and stream TV shows and anime with AI, play directly on Xiaomi TVs and Android devices.
What this kind of tool is for
- Chain multi-step workflows across the other tools in this directory.
- Run a scheduled or triggered job instead of retyping the same request.
- Have your agent watch a feed, queue, or repo and act on new items.
How to compare servers like this
- Trigger model:
- Understand what starts the automation — a command, a schedule, or an event — before relying on it.
- Blast radius:
- Prefer tools that hand you a review point before an irreversible action runs.
- Chaining cost:
- Each chained step adds a failure point; keep critical paths on the fewest tools.
- Maintenance signal:
- Automations break quietly; a maintained tool is the difference between repair and rediscovery.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the MCP Server for Binge-watch MCP server?
The MCP Server for Binge-watch is an MCP server that enables AI agents to search for and retrieve streaming URLs for TV shows and anime, with support for direct playback on Xiaomi TVs, Android TVs, and projectors. It integrates with LunaTV and MoonTV platforms to provide comprehensive video discovery and playback capabilities.
This server gives Claude and other AI agents the ability to search for TV shows and anime across multiple streaming sources, retrieve playback URLs, and send videos directly to Xiaomi TVs, Android TVs, projectors, and set-top boxes. It's designed for users who want AI-assisted TV discovery and one-click playback on their living room devices.
How to install MCP Server for Binge-watch
Copy-paste configuration for popular MCP clients.
TRANSPORTTransport protocol to use
{
"mcpServers": {
"mcp-vods": {
"command": "uvx",
"args": [
"mcp-vods"
],
"env": {
"TRANSPORT": "<YOUR_TRANSPORT>"
}
}
}
}Tools & capabilities
Tools this server exposes to the agent.
search_vods— Search for TV shows and anime across configured streaming sourcesplay_on_device— Send video to Xiaomi TV, Android TV, TvBox, or projector for playback
Use cases
- Search for TV shows and anime episodes across multiple streaming platforms using natural language
- Automatically play found videos on your Xiaomi TV or Android TV without manual URL entry
- Manage multiple TVs in different rooms and send content to specific devices
- Cache search results to reduce API calls and improve response speed
- Integrate with Home Assistant for voice-controlled TV discovery and playback
MCP Server for Binge-watch MCP server FAQ
It's an MCP server that lets AI agents search for TV shows and anime streaming URLs and play them directly on Xiaomi TVs, Android TVs, projectors, and set-top boxes.
Yes, the server itself is free and open-source. You may need to configure your own LunaTV/MoonTV instance or use the default built-in configuration.
Click the Cursor install badge in the README, or manually add it via the MCP settings with command `uvx mcp-vods`.
Optional. If using a deployed LunaTV instance, you can provide LUNA_USERNAME and LUNA_PASSWORD. Otherwise, it works out-of-the-box with default sources.
Xiaomi TVs, Android TVs with TvBox installed, projectors, and set-top boxes. Configure via MITV_LIST_CFG, TVBOX_LIST_CFG, or MITV_LOCAL_IP environment variables.
Yes, there's a Home Assistant add-on available via the hasscc/addons repository.
README (reference)
Source of truth, from the repository.
📺 MCP Server for Binge-watch
<!-- mcp-name: io.github.aahl/mcp-vods -->一个用于追剧/追番的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
🔗 Links
Related MCP servers

AkTools MCP Server
Query stock, crypto prices, financial indicators, and market news via akshare through MCP.

Notify MCP Server
Send notifications to WeChat, Telegram, Bark, Lark, Feishu, DingTalk, and Home Assistant.

useqr-mcp
Static QR PNG/SVG for agents. Designer and dynamic codes live at useqr.co.

io.github.aahlijia/dekko
Static code map generator: MAP.md + map.json for any repo, plus a Claude Code /map plugin

Loa Healthcare Pricing
Search source-labeled hospital prices, CPT codes, providers, and healthcare cost estimates.