Video Analyzer

io.github.BrightWayAI由 GitHub 账号 BrightWayAI 发布v0.1.2更新于 Oct 24, 2026

Analyze videos: extract frames, transcribe audio, generate storyboard breakdowns.

已验证STDIO仅桌面媒体与设计AI 与机器学习

概览

AI 生成的概览

让助手通过提取关键帧、转写音频并生成分镜脚本来分析视频。

可以做什么
运行视频分析流程：下载视频，使用场景检测或固定间隔提取代表性帧，用 OpenAI Whisper 转写音频，并用 Claude Vision 描述画面。它还会生成 8 项风格指纹，并可输出逐镜头分镜脚本为 .docx 或 .md 文件。工具包括 video_analyze、video_extract_frames、video_transcribe、video_fingerprint 和 video_check_deps。
适用场景
适合需要助手总结或拆解视频、提取关键帧、获取带时间戳的转写文本，或生成分镜文档的场景。对审阅素材或网络视频的创作者、剪辑师或分析师尤为有用。
运行要求
作为本地 Python 包（video-analyzer-mcp）通过 uvx 或 pip 运行，需要 Python 3.10+ 和已安装的 FFmpeg。需要 ANTHROPIC_API_KEY 环境变量，以及用于下载视频和调用转写与视觉服务的网络访问。
安装前请注意
需要 ANTHROPIC_API_KEY 密钥，该密钥会传给服务器并用于 Claude Vision 调用。视频内容和音频会发送到第三方服务（Anthropic 和 OpenAI Whisper）进行分析。它会从 URL 下载视频，因此只应指向可信来源，并注意 API 使用费用。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Video Analyzer，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Video Analyzer

Analyze videos and generate storyboard breakdowns. Extracts frames via scene detection, transcribes audio with Whisper, analyzes visuals with Claude Vision, and computes 8-field stylistic fingerprints.

Features

  • Frame Extraction — Scene-detection-based keyframe selection (or fixed intervals)
  • Audio Transcription — Timestamped transcription via OpenAI Whisper
  • Visual Analysis — Per-frame descriptions using Claude Vision
  • Stylistic Fingerprint v3 — 8-field deterministic classification (rendering class, world type, character strategy, narrative structure, visual abstraction, visual density, camera language, tonal positioning)
  • Storyboard Output — Combined shot-by-shot breakdown as .docx or .md

MCP Server

This project includes an MCP (Model Context Protocol) server so you can use video analysis directly from Claude Desktop or Claude Code.

Install via Claude Code

bash
claude mcp add video-analyzer -s user -- uvx video-analyzer-mcp

Install via Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "video-analyzer": {      "command": "uvx",      "args": ["video-analyzer-mcp"],      "env": {        "ANTHROPIC_API_KEY": "your-key-here"      }    }  }}

MCP Tools

ToolDescription
video_analyzeFull pipeline: download, extract frames, transcribe, analyze, fingerprint, storyboard
video_extract_framesExtract representative frames using scene detection or fixed intervals
video_transcribeTranscribe audio with OpenAI Whisper
video_fingerprintGenerate 8-field Stylistic Fingerprint v3 classification
video_check_depsVerify all required dependencies are installed

Standalone Usage

bash
pip install -r requirements.txtpython3 analyze_video.py "https://youtube.com/watch?v=..." --output-dir ./output

Prerequisites

  • Python 3.10+
  • FFmpeg — brew install ffmpeg (macOS) or apt-get install ffmpeg (Linux)
  • ANTHROPIC_API_KEY — set as an environment variable

Stylistic Fingerprint Fields

  1. Rendering Class — Stylized 3D, Flat 2D, Minimalist Line Art, Textured 2D, Mixed Media, Photoreal
  2. World Type — Stylized Real-World, Abstract Concept Space, Data/Presentation Space, Fictional Metaphor Universe
  3. Character Strategy — None, Mascot-Led, Single Narrator, Single Protagonist Arc, Ensemble Cast
  4. Narrative Structure — Direct Explanation, Step-by-Step, Problem-Solution, Analogy, Myth-Busting, etc.
  5. Visual Abstraction Index — 1 (Photorealistic) to 5 (Maximum Abstraction)
  6. Visual Density — Minimal, Sparse, Moderate, High
  7. Camera/Editing Language — Cinematic, Social Vertical Punch, Presentation Deck, Static Slides, etc.
  8. Tonal Positioning — Institutional, Corporate Professional, Gen Z Social, Child-Friendly, Dark Editorial

License

MIT

来源：README.md，提交 7e2705f

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.2最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。