Video URL Analyzer

Video Analyzer MCP Server

Analyze any video with AI — YouTube, TikTok & Instagram

Powered by Google Gemini 3.8 Flash · FastMCP · yt-dlp

Features · Architecture · Quick Start · Integration · Security · العربية

---

Features

v1.6.0 exposes 18 MCP tools:

Supported Platforms

Photo / Slideshow Posts

YouTube videos are analyzed directly through Gemini's native video understanding — zero download, zero upload, maximum speed.

For YouTube evidence assets, source.mp4 is not always required: saved contexts keep the original URL, so frame/clip tools can use the local stream fast path later.

---

Architecture

Operating Modes

These are behavior modes, not tool names:

---

Quick Start

The packaged runtime lives at src/video_url_analyzer_mcp/server.py; the console entry point is video_url_analyzer_mcp:main. Pick whichever install path matches your workflow.

Option A — one-line Windows installer (recommended for new users)

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

The installer follows the current MCP client pattern: it installs/runs from PyPI with uvx, uses an existing GEMINI_API_KEY environment variable when one is already set, otherwise asks for the key only through a hidden prompt, and lets the user choose where to register the server:

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

Do not append your API key to the PowerShell command. If you skip the key, the installer still registers the server and you can set GEMINI_API_KEY later. If GEMINI_API_KEY is already set in your User environment, the installer will use it directly and print only a masked form like AIza...abcd.

Option B — uvx (no install)

uvx video-url-analyzer-mcp

Works on Windows / macOS / Linux as long as uv is on PATH.

Option C — Windows wizard from a checkout

git clone https://github.com/u2n4/video-url-analyzer-mcp.git

cd video-url-analyzer-mcp powershell -ExecutionPolicy Bypass -File scripts\install_windows.ps1

The wizard:

• Verifies Python 3.10+ and (optionally) uv.
• Installs the package as an editable checkout or via uv tool install.
• Lets you save GEMINI_API_KEY to a User environment variable or to a gitignored .env.keys.local. Keys are never printed; the wizard shows only their length.
• Lets you pick a default model via VIDEO_ANALYZER_MODEL.
• Runs an offline import smoke test.
• Hands off to scripts/configure_mcp_clients.ps1 for client setup.

Option D — Manual install (any 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

Get a free key at Google AI Studio, then set it once in your shell environment (setx GEMINI_API_KEY ... on Windows, or your ~/.zshrc / ~/.bashrc on macOS/Linux). For local dev only, you can also put it in a gitignored .env file in the repo root. The server reads .env. start.bat also reads .env.keys.local, which the wizard writes.

Windows launcher

start.bat loads .env.keys.local (if present), sets VIDEO_ANALYZER_MODE=auto when it is unset, and runs python -m video_url_analyzer_mcp. It sets no model id, so the model variables from your environment or .env apply, as the table below describes. Use it as a command value in any MCP client that prefers a single executable.

---

Integration

Run scripts/configure_mcp_clients.ps1 for an interactive menu, or copy the snippets below from docs/mcp-config-examples.md. The wizard backs up existing client config, validates JSON/TOML, and never overwrites unrelated MCP servers.

Client configs use video-analyzer as the local MCP server entry name. The published package remains video-url-analyzer-mcp, and the registry name remains 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"] } } }

The wizard prefers leaving the API key in your OS environment. If you must embed it, add "env": { "GEMINI_API_KEY": "YOUR_KEY_HERE" }.

Claude Code (CLI)

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

Or, after pip install -e . in the repo:

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

Workspace registration writes .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}" } } } }

For all clients, restart the application after editing config so the new MCP server is picked up. Full snippets — including Cursor, Windsurf, Antigravity (%USERPROFILE%\.gemini\antigravity\mcp_config.json), and Cline — live in docs/mcp-config-examples.md.

---

Usage Examples

# Full video analysis with Gemini 3.8 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_vi