MCP Vods

📺 一気見用MCPサーバー

AIに映画やテレビ番組の再生アドレスを検索する機能を提供し、小米テレビで直接再生できる、一気見（追剧/追番）用のMCPサーバーです。

🚀 クイックスタート

• 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

✨ 主な機能

この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" # ストリーミング可能なHTTP
    }
  }
}

方法3: Home Assistant OS アドオン

🔧 技術詳細

⚙️ 環境変数

設定不要ですぐに使える

• 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: 1台の小米テレビのローカルIP。オプション
• MITV_LIST_CFG: 複数の小米テレビの設定。オプション。例: リビングルームのテレビ:192.168.1.11;ベッドルームのテレビ:192.168.1.12

その他のAndroidテレビ/プロジェクター/セットトップボックス

非小米のAndroidテレビで動画を再生する場合は、TvBoxをインストールし、TVBOX_LOCAL_IPまたはTVBOX_LIST_CFGの少なくとも一方を設定する必要があります。

• TVBOX_LOCAL_IP: 1台のテレビのローカルIP。オプション
• TVBOX_LIST_CFG: 複数のテレビの設定。オプション。例: リビングルームのテレビ:192.168.1.11;ベッドルームのテレビ:192.168.1.12

🔗 リンク

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