M

MCP Server for Binge-watch

MCP Server for Binge-watch

本地服务

github.com/aahl游戏娱乐2735 周前更新

关于 MCP Server for Binge-watch

MCP Server for Binge-watch（MoonTV / LunaTV）是一个追剧、追番用的 MCP 服务，让 AI 能够搜索影视播放地址，并可将视频推送到小米及其他安卓电视、投影仪上播放。适合已部署 LunaTV 或 MoonTV 的用户。

主要功能

01搜索影视播放地址
02对接已部署的 LunaTV / MoonTV
03支持 uvx、Docker 等多种安装方式
04推送播放至小米电视
05支持其他安卓电视（需安装 TvBox）

适用场景

01让 AI 助手查找某部剧集的播放地址
02在客厅或卧室电视上直接播放搜索到的视频
03通过 Claude Code 或 Cursor 等客户端调用影视搜索

MCP 相关

该项目是 MCP 服务，向 MCP 客户端提供搜索影视播放地址和投屏播放的能力。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "aahl-mcp-vods": {
      "command": "uvx",
      "args": [
        "mcp-vods"
      ],
      "env": {
        "TRANSPORT": "<TRANSPORT>"
      }
    }
  }
}

启动命令uvx mcp-vods

需要配置的环境变量

TRANSPORTTransport protocol to use

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypimcp-vods0.1.9stdio

ocighcr.io/aahl/mcp-vods:lateststdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

来自项目 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
添加到 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

🔗 Links

评论

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。