用途：分析给定视频并回答用户问题；若未提问则做摘要，回答中始终标注时间戳（M:SS）。支持 Loom、YouTube、Vimeo、TikTok、Instagram、X/Twitter、Twitch、Dailymotion、Facebook、直链 URL 或本地文件。
主要能力：转录（带时间戳）、关键帧、OCR 屏幕文字、时间线、元数据（标题/时长/播放量/评论）。可按问题选择工具：一般问题用 analyze_video（detail 为 standard）；特定时刻用 analyze_moment 或 get_frame_at；仅凭语音可答用 get_transcript（快、无需下载）；只要元数据用 get_metadata；运动或快速 UI 变化用 get_frame_burst，亚秒级运动可用小数边界（如 0:01.1 到 0:01.3）。密集 UI（终端、仪表盘、IDE、表格）可传 maxWidth，默认帧宽上限 800px，maxWidth: 0 保留源分辨率，1568 为折中。
使用方式：若会话中已连接 video-analyzer MCP 服务器，直接调用其工具，不要用 CLI。否则在任意有 shell 的 agent 中运行一次性 CLI：npx -y mcp-video-analyzer@latest analyze "<video-url-or-path>"。stdout 为单个 JSON，含 metadata、transcript、ocrResults、timeline、warnings 和 frames（{ time, filePath, mimeType } 指向磁盘 JPEG 关键帧）。解析 JSON，按需并行读取 frames[].filePath 图像，结合转录、OCR 与帧作答并标注时间戳。常用参数：--detail brief|standard|detailed（brief 仅元数据+转录，快且省）、--fields metadata,transcript、--max-frames <1-60>、--max-width <px>、--language <code>、--out <dir>、--force-refresh；完整列表见 analyze --help。
前提与降级：需 Node.js 22.12+；ffmpeg 已内置。平台 URL 需 PATH 中有 yt-dlp；直链 .mp4/.webm/.mov 与本地文件无需。Loom 转录、元数据、评论无需 yt-dlp，但 Loom 帧通常需要。工具不会因部分结果失败，warnings 数组给出可操作提示（安装 yt-dlp、YTDLP_COOKIES_FROM_BROWSER、缺少 Whisper 后端），应转达用户而非当作错误。空转录加“silent audio”警告表示视频确实无语音。仅接受指向公网地址的 http(s) URL；localhost、私有/LAN 段、.local、UNC 共享或非 HTTP 协议会被直接拒绝，这是有意拒绝，不要重试或绕过；确需内网视频时，用 MCP_ALLOW_PRIVATE_URLS=1 重启服务器，云元数据端点仍被阻止。