Video Analyzer MCP Server

Claude Code 用の動画解析 MCP サーバー。動画のメタデータ取得、フレーム抽出、音声文字起こし、Gemini による AI 解析ができます。

できること

ツール	機能
get_video_info	動画のメタデータ取得（時間、解像度、コーデック、fps等）
extract_frames	動画からフレーム画像を抽出（JPEG）
transcribe_video	音声の文字起こし（Whisper使用、日本語対応）
analyze_video_with_gemini	Gemini API による動画内容のAI解析（オプション）
cleanup_frames	抽出したフレーム画像の一時ファイルを削除

前提条件

• Python 3.10+
• ffmpeg（brew install ffmpeg）

インストール

# 1. リポジトリをクローン
git clone https://github.com/FP-sudo/video-analyzer-mcp.git ~/.claude/mcp-servers/video-analyzer
cd ~/.claude/mcp-servers/video-analyzer

# 2. 仮想環境を作成
python3 -m venv venv
source venv/bin/activate

# 3. 依存パッケージをインストール
pip install -r requirements.txt

設定

~/.mcp.json に以下を追記:

{
  "mcpServers": {
    "video-analyzer": {
      "command": "/Users/YOUR_USERNAME/.claude/mcp-servers/video-analyzer/venv/bin/python",
      "args": ["/Users/YOUR_USERNAME/.claude/mcp-servers/video-analyzer/server.py"],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
      }
    }
  }
}

• YOUR_USERNAME を自分のユーザー名に置き換えてください
• GEMINI_API_KEY は Google AI Studio で取得（Gemini解析を使わない場合は空文字でOK）

使い方

Claude Code で動画ファイルのパスを渡すだけ:

この動画の内容を教えて: /path/to/video.mp4

Claude Code が自動的に以下を実行します:

1. メタデータ取得
2. フレーム抽出 → 画像を表示
3. 音声文字起こし
4. 結果をまとめて報告

ライセンス

MIT