MCP Server for Binge-watch

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

AI & MLPythonv0.1.9

📺 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 Install MCP Server
  • 添加到 VS Code Install MCP Server
  • 添加到 Cherry Studio Install MCP Server

🎓 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

🔗 Links

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx mcp-vods

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-aahl-mcp-vods": {
      "command": "uvx",
      "args": [
        "mcp-vods"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

mcp-vodspypi

Compatible MCP Clients

MCP Server for Binge-watch works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More