Features
v1.5.4 exposes 18 MCP tools:
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
uvx video-url-analyzer-mcp==1.5.1Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add u2n4-video-url-analyzer-mcp -- uvx video-url-analyzer-mcp==1.5.1在終端機中執行。
{ "mcpServers": { "u2n4-video-url-analyzer-mcp": { "command": "uvx", "args": [ "video-url-analyzer-mcp==1.5.1" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
v1.5.4 exposes 18 MCP tools:
MCP server to analyze YouTube, TikTok & Instagram videos from URL — transcripts, AI insights, tutorial extraction
| Full audio + visual analysis with custom prompts. Uses Gemini multimodal understanding. |
get_transcript | Extract timestamped transcript with speaker identification. Supports 100+ languages via auto-detection. |
ask_about_video | Ask any question about the video content. |
prepare_slideshow_assets | Return ordered slideshow images as MCP image blocks so Claude/the client AI can inspect them directly. |
find_video_moments | Find matching moments with compact/standard/full structured output. |
analyze_video_segment | Analyze only a selected time range. |
prepare_video_context | Analyze once and save a reusable local context for follow-up questions and evidence lookup. |
ask_video_context | Answer from saved context by default; Gemini reanalysis is explicit opt-in. |
list_video_contexts | List saved local contexts. |
delete_video_context | Delete one saved context. |
get_video_frame | Extract a local still frame, using the YouTube fast path when possible. |
get_video_clip | Extract a short local clip, with a 30s cap and YouTube fast path when possible. |
get_video_evidence_asset | Select saved evidence and return a frame or clip reference. |
list_video_sources | Inspect local source/context/asset cache metadata. |
cleanup_video_cache | Dry-run or clean managed cache files; dry-run is the default. |
watch_and_analyze | Extract tutorial steps, shell commands, code snippets, and file paths from technical videos. |
execute_tutorial_steps | Validate and review extracted steps safely; executes only with confirmation. |
check_analysis_job | Poll background job status for TikTok/Instagram async downloads. |
YouTube videos are analyzed directly through Gemini's native video understanding — zero download, zero upload, maximum speed. For YouTube evidence assets,
source.mp4is not always required: saved contexts keep the original URL, so frame/clip tools can use the local stream fast path later.
These are behavior modes, not tool names:
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.
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:
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.
uvx (no install)uvx video-url-analyzer-mcp
Works on Windows / macOS / Linux as long as uv is on PATH.
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:
uv.uv tool install.GEMINI_API_KEY to a User environment variable or to a
gitignored .env.keys.local. Keys are masked in logs (AIza...abcd),
never printed in full.VIDEO_ANALYZER_MODEL.scripts/configure_mcp_clients.ps1 for client setup.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 drop it in a gitignored .env.keys.local next to the
repo.
start.bat loads .env.keys.local (if present), sets safe defaults
(VIDEO_ANALYZER_MODE=auto), and runs python -m video_url_analyzer_mcp.
Use it as a command value in any MCP client that prefers a single
executable.
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.
%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 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/config.toml)[mcp_servers.video-analyzer]
command = "uvx"
args = ["video-url-analyzer-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.
# 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")
This server has been hardened against a comprehensive threat model audit:
Default fast model:
gemini-3.5-flash. Default deep model (used whendetail="full"):gemini-3.1-pro-preview. SetVIDEO_ANALYZER_MODELto override both at once. Model availability can vary by Google account, region, and API tier — fall back togemini-flash-latestif the latest ids are not yet enabled for your key. |VIDEO_ANALYZER_MODE| Behavior preset (auto/api/client/local); read bystart.bat|auto|
MIT
خادم MCP لتحليل الفيديو باستخدام Google Gemini 3.5 Flash — احدث نموذج Gemini Flash متعدد الوسائط من جوجل.
استنسخ الريبو ثم شغل المعالج التفاعلي:
git clone https://github.com/u2n4/video-url-analyzer-mcp.git
cd video-url-analyzer-mcp
powershell -ExecutionPolicy Bypass -File scripts\install_windows.ps1
البديل بدون تثبيت: uvx video-url-analyzer-mcp.
الخادم محمي ضد:
.env:GEMINI_API_KEY=مفتاحك_هنا
MCP server to analyze YouTube, TikTok & Instagram videos from URL — transcripts, AI insights, tutorial extraction
{ "mcpServers": { "u2n4-video-url-analyzer-mcp": { "command": "uvx", "args": [ "video-url-analyzer-mcp==1.5.1" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Video Url Analyzer 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 MCP server to analyze YouTube, TikTok & Instagram videos from URL — transcripts, AI insights, tutorial extraction