MCP Vods

🚀 追劇/追番MCP服務器

這是一個用於追劇/追番的MCP服務器，能為AI提供搜索影視播放地址的能力，還支持在小米電視上直接播放。

🚀 快速開始

• 添加到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

📦 安裝指南

方式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

🔧 技術細節

⚙️ 環境變量

免配置開箱即用

• 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

🔗 相關鏈接

• https://zread.ai/aahl/mcp-vods
• LunaTV
• MoonTV