mcpField
M
MCP Server for Binge-watch

MCP Server for Binge-watch

Local
github.com/aahlGames & Entertainment27Updated 35w ago
Repository

About MCP Server for Binge-watch

MCP Server for Binge-watch is an MCP server that lets AI assistants search for video playback addresses and cast them to Xiaomi and other Android TVs or projectors. It suits users who run LunaTV or MoonTV and want to watch on a TV.

Key features

  1. 01Search video playback addresses
  2. 02Connect to deployed LunaTV or MoonTV
  3. 03Install via uvx or Docker
  4. 04Play directly on Xiaomi TVs
  5. 05Support other Android TVs through TvBox

Use cases

  1. 01Ask an AI assistant to find where a series can be played
  2. 02Start a search result on a living room or bedroom TV
  3. 03Call video search from Claude Code or Cursor

MCP support

This is an MCP server that exposes video playback address search and TV casting to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "aahl-mcp-vods": {
      "command": "uvx",
      "args": [
        "mcp-vods"
      ],
      "env": {
        "TRANSPORT": "<TRANSPORT>"
      }
    }
  }
}
Run commanduvx mcp-vods
Environment variables to set
TRANSPORTTransport protocol to use

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-vods0.1.9
ocighcr.io/aahl/mcp-vods:latest

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

📺 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.