MCP Server for Binge-watch

io.github.aahl由 GitHub 帳號 aahl 發布v0.1.9更新於 Oct 24, 2026

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

發布方自己的服務:watch.diy – DIY Store Finder

已驗證STDIO僅桌面位置與生活媒體與設計

概覽

AI 產生的概覽

一個本機 MCP 伺服器,讓助理搜尋 LunaTV/MoonTV 影視來源取得播放位址,並投放到小米或其他 Android 電視上播放。

可以做什麼
搜尋 LunaTV/MoonTV 訂閱來源中的影視播放位址,支援快取與單次搜尋站點數限制。使用已部署的 LunaTV 或 MoonTV 服務作為片源。依本機 IP 在小米電視、投影機或機上盒上播放找到的影片。在安裝了 TvBox 的其他 Android 電視上播放,同樣依本機 IP 設定。在一份設定中管理多台具名裝置。
適用情境
適合希望助理查找劇集或動畫的播放來源,並在家庭網路中的電視上直接開始播放的情境,尤其是使用 LunaTV/MoonTV 片源與小米或 TvBox 裝置時。
執行需求
透過 uvx(PyPI 套件 mcp-vods)或 Docker 在本機執行;Docker 方式提供 Streamable HTTP 端點。選用環境變數: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。電視需可在本機網路中連線;非小米 Android 電視需安裝 TvBox。
安裝前請注意
LUNA_USERNAME 與 LUNA_PASSWORD 是作為環境變數傳入的帳號憑證。伺服器可在你網路中的電視上啟動播放,裝置 IP 與存取應限制在可信網路內。它會連線外部訂閱來源與 LunaTV/MoonTV 服務,搜尋查詢與來源位址會離開本機。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 MCP Server for Binge-watch,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

來源:README.md,提交 d18ae19

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.9最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Watch 整合