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 分

    請在儲存庫或註冊中心條目中宣告授權條款。