• 在客厅电视播放《仙逆》最新一集
• 《凡人修仙传》更新到多少集了？

安装

方式 1: uvx

{
  "mcpServers": {
    "mcp-vods": {
      "command": "uvx",
      "args": ["mcp-vods"],
      "env": {
        "SEARCH_CACHE_TTL": "5"
      }
    }
  }
}

方式 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": {
    "mcp-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

环境变量

免配置开箱即用

• VOD_CONFIG_URL: 远程配置文件 URL，可选 (默认已内置)
• SEARCH_CACHE_TTL: 搜索缓存 TTL，可选 (默认 5 分钟)
• MAX_SEARCH_SITES: 搜索次数限制，可选 (默认 10)

使用已部署的 LunaTV/MoonTV

• MOON_BASE_URL: 已部署的 MoonTV 服务地址，可选，如: http://localhost: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