MCP Server for Binge-watch

io.github.aahlPublished by GitHub account aahlv0.1.9Updated Oct 24, 2026

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

The publisher's own server: watch.diy – DIY Store Finder

VerifiedSTDIODesktop onlyLocation & LifestyleMedia & Design

Overview

AI-generated overview

A local MCP server that lets an assistant search LunaTV/MoonTV video sources for playback addresses and cast them to Xiaomi or other Android TVs.

What you can do
Search LunaTV/MoonTV subscription sources for film and TV playback addresses, with caching and a per-search site limit. Use an already deployed LunaTV or MoonTV service as the source. Play found videos on Xiaomi TVs, projectors or set-top boxes configured by local IP. Play on other Android TVs that run TvBox, also configured by local IP. Manage multiple named devices in one configuration.
When to use it
Useful when you want an assistant to look up where a show or anime can be streamed and start playback on a TV in your home network, especially with LunaTV/MoonTV sources and Xiaomi or TvBox devices.
Requirements
Runs locally via uvx (PyPI package mcp-vods) or Docker; the Docker route exposes a Streamable HTTP endpoint. Optional environment variables: VOD_CONFIG_URL, SEARCH_CACHE_TTL, MAX_SEARCH_SITES, MOON_BASE_URL, LUNA_BASE_URL, LUNA_USERNAME, LUNA_PASSWORD, MITV_LOCAL_IP, MITV_LIST_CFG, TVBOX_LOCAL_IP, TVBOX_LIST_CFG, TRANSPORT. TVs must be reachable on the local network; non-Xiaomi Android TVs need TvBox installed.
Before you install
LUNA_USERNAME and LUNA_PASSWORD are account credentials passed as environment variables. The server can start playback on TVs on your network, so device IPs and access should be limited to trusted networks. It contacts external subscription sources and LunaTV/MoonTV services, so search queries and source URLs leave your machine.

Installation

In SourceWeft

  1. Open MCP Server for Binge-watch in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

📺 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-vodscd /opt/mcp-vodswget https://raw.githubusercontent.com/aahl/mcp-vods/refs/heads/main/docker-compose.ymldocker-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 [Install MCP Server]
  • 添加到 VS Code [Install MCP Server]
  • 添加到 Cherry Studio [Install MCP Server]

🎓 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

🔗 Links

Source: README.md at commit d18ae19

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.9LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Watch integrations