About Vods
Vods is an MCP server published by aahl in the Developer Tools category: 📺 MCP Server for Binge-watch / MoonTV / LunaTV. 一个用于追剧/追番的MCP服务器，为AI提供搜索影视播放地址的能力，并支持在小米电视上直接播放.
The repository has 27 stars and 5 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/aahl/mcp-vodsThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Vods
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
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-vodsclaude 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:3000LUNA_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 fetched from the repository 5 hours ago. The original is authoritative.