MCP Server for Binge-watch

Official registry Other

MCP Server for Binge-watch / MoonTV / LunaTV. 一个用于追剧/追番的MCP服务器,为AI提供搜索影视播放地址的能力,并支持在小米等安卓电视/投影仪上直接播放

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mcp-vods
Claude Code
claude mcp add mcp-server-for-binge-watch -- uvx mcp-vods==0.1.9
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "mcp-server-for-binge-watch": {
            "command": "uvx",
            "args": [
                "mcp-vods==0.1.9"
            ]
        }
    }
}
OCI package ghcr.io/aahl/mcp-vods:latest
Claude Code
claude mcp add mcp-server-for-binge-watch -e 'TRANSPORT=stdio' -- docker run -i --rm ghcr.io/aahl/mcp-vods:latest
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "mcp-server-for-binge-watch": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/aahl/mcp-vods:latest"
            ],
            "env": {
                "TRANSPORT": "stdio"
            }
        }
    }
}

Environment variables

  • TRANSPORT Transport protocol to use

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

📺 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-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
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

Frequently asked questions

What is MCP Server for Binge-watch?

MCP Server for Binge-watch / MoonTV / LunaTV. 一个用于追剧/追番的MCP服务器,为AI提供搜索影视播放地址的能力,并支持在小米等安卓电视/投影仪上直接播放

How do I install MCP Server for Binge-watch?

It runs on your machine. In Claude Code: claude mcp add mcp-server-for-binge-watch -- uvx mcp-vods==0.1.9. For other clients, paste the JSON configuration from this page into their MCP settings.

Does MCP Server for Binge-watch need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is MCP Server for Binge-watch open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains MCP Server for Binge-watch?

It is published by aahl. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.