Video URL Analyzer

Video Analyzer MCP サーバー

AI であらゆる動画を分析 — YouTube、TikTok、Instagram
Google Gemini 3.5 Flash · FastMCP · yt-dlp を利用

機能 · アーキテクチャ · クイックスタート · 連携 · セキュリティ · العربية

機能

v1.5.4 では 18 個の MCP ツールを提供します。

対応プラットフォーム

写真／スライドショー投稿

YouTube 動画は Gemini のネイティブな動画理解機能を通じて直接分析されます。ダウンロードもアップロードも不要で、最大限の速度を実現します。 YouTube の証拠アセットでは、source.mp4 が常に必要とは限りません。保存されたコンテキストには元の URL が保持されるため、フレーム／クリップツールは後からローカルストリームの高速経路を利用できます。

アーキテクチャ

動作モード

これらは動作モードであり、ツール名ではありません。

クイックスタート

パッケージ化されたランタイムは src/video_url_analyzer_mcp/server.py にあり、 コンソールのエントリーポイントは video_url_analyzer_mcp:main です。ワークフローに合ったインストール方法を選んでください。

オプション A — Windows 用ワンラインインストーラー（新規ユーザーに推奨）

irm https://raw.githubusercontent.com/u2n4/video-url-analyzer-mcp/main/install.ps1 | iex

インストーラーは現在の MCP クライアントの一般的な方法に従っています。PyPI から uvx でインストール／実行し、既存の GEMINI_API_KEY 環境変数が設定されている場合はそれを使用します。設定されていない場合は、非表示のプロンプトでのみキーを尋ね、サーバーの登録先を選択できます。

• Claude Code
• Claude Desktop
• Codex CLI
• Cursor
• Windsurf
• VS Code / GitHub Copilot
• Google Antigravity
• Cline

PowerShell コマンドに API キーを追加しないでください。キーを入力しなくても、インストーラーはサーバーを登録します。GEMINI_API_KEY は後から設定できます。GEMINI_API_KEY がすでにユーザー環境変数に設定されている場合、インストーラーはその値を直接使用し、AIza...abcd のようにマスクされた形式のみを表示します。

オプション B — uvx（インストール不要）

uvx video-url-analyzer-mcp

uv が PATH にあれば、Windows／macOS／Linux で動作します。

オプション C — チェックアウトから起動する Windows ウィザード

git clone https://github.com/u2n4/video-url-analyzer-mcp.git
cd video-url-analyzer-mcp
powershell -ExecutionPolicy Bypass -File scripts\install_windows.ps1

ウィザードでは、次の操作を行います。

• Python 3.10 以降と、必要に応じて uv を検証します。
• パッケージを編集可能なチェックアウトとしてインストールするか、uv tool install でインストールします。
• GEMINI_API_KEY をユーザー環境変数 または Git で無視される .env.keys.local に保存できます。ログではキーがマスクされ（AIza...abcd）、全文が表示されることはありません。
• VIDEO_ANALYZER_MODEL を使ってデフォルトモデルを選択できます。
• オフラインのインポートスモークテストを実行します。
• クライアントのセットアップでは scripts/configure_mcp_clients.ps1 に引き継ぎます。

オプション D — 手動インストール（すべての OS）

git clone https://github.com/u2n4/video-url-analyzer-mcp.git
cd video-url-analyzer-mcp
pip install -e .
python -m video_url_analyzer_mcp

Google AI Studio で無料のキーを取得し、シェル環境に一度設定します（Windows では setx GEMINI_API_KEY ...、macOS/Linux では ~/.zshrc または ~/.bashrc）。ローカル開発専用であれば、リポジトリの隣にある、Git で無視される .env.keys.local に保存することもできます。

Windows ランチャー

start.bat は .env.keys.local（存在する場合）を読み込み、安全なデフォルト値（VIDEO_ANALYZER_MODE=auto）を設定して、python -m video_url_analyzer_mcp を実行します。単一の実行ファイルを指定する MCP クライアントでは、command の値として使用してください。

統合

対話型メニューを使うには scripts/configure_mcp_clients.ps1 を実行するか、docs/mcp-config-examples.md のスニペットをコピーしてください。ウィザードは既存のクライアント設定をバックアップし、JSON/TOML を検証します。また、関係のない MCP サーバーを上書きすることはありません。

クライアント設定では、ローカル MCP サーバーのエントリ名に video-analyzer を使用します。公開パッケージ名は引き続き video-url-analyzer-mcp、レジストリ名は引き続き io.github.u2n4/video-url-analyzer-mcp です。

Claude Desktop（%APPDATA%\Claude\claude_desktop_config.json）

{
  "mcpServers": {
    "video-analyzer": {
      "command": "uvx",
      "args": ["video-url-analyzer-mcp"]
    }
  }
}

ウィザードでは、API キーを OS 環境変数に保存する方法が優先されます。キーを設定に埋め込む必要がある場合は、"env": { "GEMINI_API_KEY": "YOUR_KEY_HERE" } を追加してください。

Claude Code（CLI）

claude mcp add video-analyzer --transport stdio -- uvx video-url-analyzer-mcp

または、リポジトリ内で pip install -e . を実行した後に、次のようにします。

claude mcp add video-analyzer --transport stdio -- python -m video_url_analyzer_mcp

Codex CLI（~/.codex/config.toml）

[mcp_servers.video-analyzer]
command = "uvx"
args = ["video-url-analyzer-mcp"]

VS Code / GitHub Copilot MCP

ワークスペースの登録では .vscode/mcp.json に書き込みます。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "video-url-analyzer-gemini-api-key",
      "description": "Gemini API key for video-url-analyzer-mcp",
      "password": true
    }
  ],
  "servers": {
    "video-analyzer": {
      "type": "stdio",
      "command": "uvx",
      "args": ["video-url-analyzer-mcp"],
      "env": {
        "GEMINI_API_KEY": "${input:video-url-analyzer-gemini-api-key}"
      }
    }
  }
}

すべてのクライアントで、設定を編集した後、新しい MCP サーバーが読み込まれるようにアプリケーションを再起動してください。Cursor、Windsurf、Antigravity（%USERPROFILE%\.gemini\antigravity\mcp_config.json）、Cline を含むすべてのスニペットは、docs/mcp-config-examples.md にあります。

使用例

# Full video analysis with Gemini 3.5 Flash
analyze_video("https://www.youtube.com/watch?v=dQw4w9WgXcQ")

# Custom analysis prompt
analyze_video("https://www.tiktok.com/@user/video/123",
              prompt="List every product shown and estimate prices")

# Multilingual transcript extraction
get_transcript("https://www.instagram.com/reel/ABC123/", lang="ar")

# Ask specific questions about video content
ask_about_video("https://youtu.be/abc",
                question="What programming language is used in the tutorial?")

# Analyze once, then ask locally from the saved context
prepare_video_context("https://youtu.be/abc", detail="standard")
ask_video_context("https://youtu.be/abc",
                  question="What happens near the end?")

# Extract visual evidence without embedding binary data in the tool output
get_video_frame("https://youtu.be/abc", timestamp="00:30")
get_video_clip("https://youtu.be/abc", start="00:20", end="00:28")

# Watch & build — extract tutorial steps
watch_and_analyze("https://www.youtube.com/watch?v=tutorial123")

セキュリティ

このサーバーは、包括的な脅威モデル監査に基づいてセキュリティを強化しています。

環境変数

デフォルトの高速モデル：gemini-3.5-flash。デフォルトの詳細モデル （detail="full" の場合に使用）：gemini-3.1-pro-preview。両方をまとめて上書きするには、 VIDEO_ANALYZER_MODEL を設定してください。モデルの利用可否は Google アカウント、地域、 API ティアによって異なる場合があります。最新の ID がまだお使いの キーで有効になっていない場合は、gemini-flash-latest を代わりに使用してください。 | VIDEO_ANALYZER_MODE | 動作プリセット（auto／api／client／local）。start.bat によって読み取られます | auto |

トラブルシューティング

技術スタック

ライセンス

MIT

git clone https://github.com/u2n4/video-url-analyzer-mcp.git
cd video-url-analyzer-mcp
powershell -ExecutionPolicy Bypass -File scripts\install_windows.ps1

GEMINI_API_KEY=مفتاحك_هنا