video-watcher MCP server

Claude Desktop が YouTube、Instagram、Facebook、または直接のビデオ URL（mp4/webm など）の動画を「視聴」し、それらに関する質問に回答できるようにする MCP サーバーです。

できること

対応する URL に対して、このサーバーは次のことを行います：

1. yt-dlp で動画をダウンロードします（YouTube、Instagram、Facebook を含む数百のサイトに対応。単純なファイル URL の場合は生の HTTP ダウンロードにフォールバックします）。

2. トランスクリプト（文字起こし）を抽出します — youtube-transcript-api が利用できる場合は YouTube のキャプションを、それ以外の場合は faster-whisper による音声文字起こしを使用します。

3. OpenCV を使用して、動画のタイムライン全体からサンプリングした5つのキーフレームを base64 JPEG として抽出します。

結果はプロセスが起動している間、URL ごとにメモリ内にキャッシュされるため、同じ動画に対して複数のツールを呼び出しても、ダウンロード/文字起こしは一度だけ行われます。

Related MCP server: Video MCP

ツール

• watch_video(url) — 完全な分析：タイトル、再生時間、トランスクリプト、フレーム。

• summarize_video(url) — 約200語の要約＋主要ポイントの箇条書き。

• answer_about_video(url, question) — トランスクリプト＋フレームを提供し、Claude が動画に関する具体的な質問に答えられるようにします。

セットアップ

cd D:\Projects\video-mcp-server
pip install -r requirements.txt

PATH に ffmpeg も必要です（yt-dlp の多重化と faster-whisper の音声デコードの両方で必要）。Windows では winget install ffmpeg でインストールするか、https://ffmpeg.org からダウンロードして PATH に追加してください。

まずサーバーを単体でテストしてください：

python video_mcp_server.py

stdio 上で待機しています（出力がなければ正常です。ログは stderr に出力されます）。

Claude Desktop への接続

%APPDATA%\Claude\claude_desktop_config.json を編集し（存在しない場合は作成）、以下をマージしてください：

{
  "mcpServers": {
    "video-watcher": {
      "command": "python",
      "args": ["D:\\Projects\\video-mcp-server\\video_mcp_server.py"]
    }
  }
}

このリポジトリを別の場所にクローンした場合はパスを調整してください。Claude Desktop の環境内で python が PATH にない場合は、代わりにインタープリタの完全なパスを使用してください。例："C:\\Users\\<you>\\AppData\\Local\\Programs\\Python\\Python311\\python.exe"。

設定編集後は Claude Desktop を完全に終了してから再度開いてください（Windows でもウィンドウを閉じるだけでは不十分です。システムトレイアイコンから Quit してください）。

テストする

接続できたら、以下を試してください：

• watch_video("https://www.youtube.com/watch?v=dQw4w9WgXcQ")

• summarize_video("https://www.youtube.com/shorts/<some-short-id>")

• answer_about_video("https://www.instagram.com/reel/<reel-id>/", "What product is being promoted?")

Claude に直接依頼することもできます。例：「この動画を見て要約してください：」

注意事項と制限

• Instagram: 公開の投稿/リールは yt-dlp で動作します。プライベートアカウントやログインが必要な投稿は明確なエラーで失敗します — このサーバーは Instagram の認証情報を保存・使用しません。instagrapi は将来の拡張のために任意依存として記載されていますが、現在のコードパスでは必要ありません。

• Facebook: 公開動画のみ。同じログイン必須の制約が適用されます。

• Whisper フォールバック: 文字起こしを必要とする最初の呼び出しは、初回使用時に Whisper base モデル（約150MB）をダウンロードします。

• レート制限: プラットフォームは繰り返しのリクエストを抑制することがあります。サーバーはハングせず、「レート制限されています。後でもう一度お試しください」という明確なエラーを返します。

• ストレージ: ダウンロードした動画は一時キャッシュディレクトリ（%TEMP%\video_mcp_cache）に書き込まれ、自動的にはクリーンアップされません。ディスク容量が気になる場合は定期的に削除してください。