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