mcp-video-analyzer
技能简介: mcp-video-analyzer 是一款通用的视频分析 MCP 服务器,可将任意视频——YouTube
技能简介: mcp-video-analyzer 是一款通用的视频分析 MCP 服务器,可将任意视频——YouTube、Instagram、TikTok、Loom、X(Twitter)、Vimeo、本地文件——转换为 AI agent 可用的结构化数据,包括字幕、关键帧、OCR 文字和元数据。
核心能力
- 全平台视频支持:覆盖 Loom、YouTube/Vimeo/TikTok/Instagram/X/Twitch/Dailymotion/Facebook 及直接视频 URL
- 多维度分析:同时提取字幕 transcript、关键帧 frames、OCR 文字、元数据 metadata、时间线 timeline
- 8 种分析工具:analyze_video、analyze_videos、get_transcript、get_metadata、get_frames、analyze_moment、get_frame_at、get_frame_burst
- 批量处理:支持多视频并发分析,带断点续传
- 多客户端支持:Claude Code 插件模式、通用 MCP 协议、Agent Skills 便携式技能
- 本地文件支持:支持本地视频文件分析,无需网络下载
- 缓存机制:分析结果自动缓存,支持强制刷新
安装配置
环境要求
- Node.js 22.12+
- yt-dlp(用于 YouTube/Vimeo/TikTok/Instagram/X 等平台,pip install yt-dlp)
- Chrome/Chromium(可选,用于帧提取降级)
安装步骤
方式一:Claude Code 插件安装(推荐,自动配置 MCP) /plugin marketplace add guimatheus92/mcp-video-analyzer /plugin install video@mcp-video-analyzer
方式二:Agent Skills 便携式安装(Codex/Cursor/Copilot 等) npx skills add guimatheus92/mcp-video-analyzer
方式三:MCP 手动配置(Claude Code) claude mcp add video-analyzer -- npx mcp-video-analyzer@latest
方式四:Claude Desktop 在 claude_desktop_config.json 中添加 mcpServers 配置
方式五:VS Code / Cursor MCP 设置 在 ~/.vscode/mcp.json 中添加服务器配置
使用步骤
- 安装服务:选择上述任一安装方式完成配置
- 直接提问:向 AI 助手发送视频链接,如"Analyze this video: https://www.youtube.com/watch?v=..."
- 指定分析维度:可选 --detail brief/standard/detailed,--max-frames 数量,--fields 指定字段
- 查看结果:返回 JSON 格式结构化结果,包含元数据、字幕、OCR、时间线等
- 批量分析:使用 analyze_videos 并发处理多个视频源
- 深度分析:使用 analyze_moment 对特定时间段进行深入分析
适用场景
- 视频内容分析:提取视频字幕、关键帧、UI 文字用于 AI 处理
- 社交媒体监控:批量分析多个创作者账号的视频内容
- 知识库构建:将视频内容转换为可搜索的 RAG 知识库
- 屏幕录制分析:分析屏幕录制视频,提取错误信息、UI 问题
- 视频审核:批量审核视频内容,提取文字和画面信息
- 多模态 AI 训练:为多模态 AI 模型提供视频-文字配对数据
适用人群
- AI 应用开发者
- 社交媒体运营者
- 内容创作者和研究者
- 数据标注团队
- 多模态 AI 研究人员
工作原理
mcp-video-analyzer 通过 MCP(Model Context Protocol)协议与 AI agent 通信。对于平台视频 URL,使用 yt-dlp 下载并使用 FFmpeg 提取帧;对于本地文件,直接处理。转录优先使用平台原生字幕,缺失时回退到 Whisper 语音识别。关键帧通过场景变化检测算法自动选取,静默视频回退到均匀采样。OCR 使用 Tesseract 引擎。8 个 MCP 工具对应不同分析粒度,AI 自动选择最合适的工具执行。
官方链接
- npm:https://www.npmjs.com/package/mcp-video-analyzer
- GitHub:https://github.com/guimatheus92/mcp-video-analyzer
- awesome-mcp-servers:https://github.com/punkpeye/awesome-mcp-servers
- mcp servers 列表:https://mcpservers.org/servers/guimatheus92/mcp-video-analyzer
- Glama AI:https://glama.ai/mcp/servers/guimatheus92/mcp-video-analyzer
评论与建议
登录 后参与评论或提建议