io.github.aahl/mcp-vods (MCP Server for Binge-watch)

MCP server that supports AI search for movie/TV playback addresses for binge-watching TV shows and anime. It is also designed to play directly on Xiaomi Android TVs/projectors. Source name: io.github.aahl/mcp-vods, with topics including binge-watch, mcp, and video.

🛠️ Key Features

MCP server for binge-watch / watch-through content
Provides AI capability to search影视播放地址 (video playback addresses)
Supports direct playback on 小米电视 (Xiaomi TV)

🚀 Use Cases

Find playback addresses for TV series or anime
Integrate with LLMs via MCP for retrieval of streaming/play URLs
Use on Xiaomi smart TV / projector environments

⚡ Developer Benefits

Clear server identifier: io.github.aahl/mcp-vods
Supports two deployment approaches: uvx and Docker
Docker uses a docker-compose.yml fetched from the repo

⚠️ Limitations

Setup details shown rely on a Xiaomi-related environment variable/config (MITV_LIST_CFG) and a Docker service exposing an MCP endpoint (e.g., http://0.0.0.0:8821/mcp).

📺 MCP Server for Binge-watch

一个用于追剧/追番的MCP服务器，为AI提供搜索影视播放地址的能力，并支持在小米电视上直接播放。

📲 安装

方式1: uvx

yaml

{
  "mcpServers": {
    "vods": {
      "command": "uvx",
      "args": ["mcp-vods"],
      "env": {
        "MITV_LIST_CFG": "客厅电视:192.168.1.11"
      }
    }
  }
}

方式2: Docker

bash

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

yaml

{
  "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-vods
- claude 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

shell

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:3000
LUNA_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

MCP Server for Binge-watch