Video Info MCP

🚀 🎬 Video Info MCP

🚀 MCP (Model Context Protocol) プロトコルに基づく専用のビデオ情報分析ツールで、AI アシスタントに強力なビデオファイル分析機能を提供します。

✨ 主な機能

• 🎯 専門的な分析: FFmpeg をベースにした深層的なビデオ情報抽出
• 📊 多様なデータ: ビデオストリーム、オーディオストリーム、ビットレート、品質評価
• 📝 複数のレポート形式: JSON、TEXT、Markdown 形式の出力に対応
• 🔧 MCP 互換: Model Context Protocol 規格に完全に準拠
• ⚡ 高パフォーマンス: 平均応答時間 < 500ms
• 🌐 クロスプラットフォーム: Windows、macOS、Linux をサポート
• 🛡️ 型安全: TypeScript と Zod を使用した厳格な型チェック

📦 インストール

MCP サーバーとして使用する場合（推奨）

AI アシスタントの設定ファイルに以下を追加します。

{
  "mcpServers": {
    "video-info": {
      "command": "npx",
      "args": ["@pickstar-2002/video-info-mcp@latest"],
      "env": {}
    }
  }
}

グローバルインストール

npm install -g @pickstar-2002/video-info-mcp@latest

🚀 クイックスタート

Claude Desktop の設定

1. Claude Desktop の設定ファイルを開きます。

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/claude/claude_desktop_config.json

2. MCP サーバーの設定を追加します。

{
  "mcpServers": {
    "video-info": {
      "command": "npx",
      "args": ["@pickstar-2002/video-info-mcp@latest"],
      "env": {}
    }
  }
}

3. Claude Desktop を再起動します。

その他の AI アシスタントの設定

MCP プロトコルに対応した他の AI アシスタントの場合は、対応する設定ドキュメントを参照し、以下のコマンドを使用します。

npx @pickstar-2002/video-info-mcp@latest

🛠️ 機能説明

利用可能なツール

サポートされるビデオ形式

• コンテナ形式: MP4, MOV, AVI, MKV, WebM, FLV, 3GP, M4V
• ビデオコーデック: H.264, H.265/HEVC, VP8, VP9, AV1, MPEG-4
• オーディオコーデック: AAC, MP3, AC-3, DTS, FLAC, Opus, Vorbis

💻 使用例

基本的な使用法

MCP に対応した AI アシスタントでは、自然言語で直接要求を行うことができます。

"このビデオファイルの情報を分析してください：/path/to/video.mp4"
"このビデオの技術レポートを Markdown 形式で生成してください"
"このビデオファイルのビットレート情報を計算してください"

API 呼び出し例

// get_video_info - 基本情報を取得
{
  "name": "get_video_info",
  "arguments": {
    "filePath": "/path/to/video.mp4"
  }
}

// analyze_streams - ストリーム分析
{
  "name": "analyze_streams", 
  "arguments": {
    "filePath": "/path/to/video.mp4",
    "includeMetadata": true
  }
}

// generate_report - レポート生成
{
  "name": "generate_report",
  "arguments": {
    "filePath": "/path/to/video.mp4",
    "format": "markdown"
  }
}

📊 出力例

ビデオ情報出力

{
  "filename": "sample.mp4",
  "fileSize": "20.43 MB",
  "duration": "289.4",
  "format": "mov,mp4,m4a,3gp,3g2,mj2",
  "videoStreams": [{
    "codec": "h264",
    "resolution": "1920x1080",
    "frameRate": "30/1",
    "bitRate": "423986"
  }],
  "audioStreams": [{
    "codec": "aac",
    "sampleRate": "48000",
    "channels": 2,
    "bitRate": "164221"
  }],
  "technicalReport": {
    "videoQuality": "1080p高清",
    "audioQuality": "標準品質",
    "recommendations": [
      "1080p の品質を向上させるには、ビデオのビットレートを上げることをおすすめします",
      "H.264 コーデックを使用すると、互換性が良好です"
    ]
  }
}

🔧 トラブルシューティング

よくある問題

❌ 接続エラー "Connection closed"

これは通常、npx のキャッシュ問題によるものです。以下の順序で解決を試みてください。

1. @latest タグを使用する（推奨）

{
  "mcpServers": {
    "video-info": {
      "command": "npx",
      "args": ["@pickstar-2002/video-info-mcp@latest"],
      "env": {}
    }
  }
}

2. 特定のバージョンに固定する（代替案）

{
  "mcpServers": {
    "video-info": {
      "command": "npx",
      "args": ["@pickstar-2002/video-info-mcp@1.1.0"],
      "env": {}
    }
  }
}

3. npx キャッシュをクリアする（最終手段）

# npx キャッシュをクリアする
npx clear-npx-cache

# または、キャッシュディレクトリを手動で削除する
# Windows: %LOCALAPPDATA%\npm-cache\_npx
# macOS/Linux: ~/.npm/_npx

❌ FFmpeg が見つからない

システムに FFmpeg がインストールされていることを確認してください。

Windows:

# Chocolatey を使用する
choco install ffmpeg

# Scoop を使用する  
scoop install ffmpeg

macOS:

# Homebrew を使用する
brew install ffmpeg

Linux:

# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg

# CentOS/RHEL
sudo yum install ffmpeg

❌ 権限エラー

AI アシスタントがビデオファイルのパスにアクセスできる権限を持っていることを確認し、絶対パスの使用をおすすめします。

❌ ファイル形式がサポートされていない

ビデオファイルが損傷していないことを確認するか、他のツールを使用して一般的な形式（MP4 など）に変換してみてください。

パフォーマンス最適化の提案

• 🚀 大きなファイル（>1GB）の場合、分析に時間がかかることがあります。
• 💾 分析速度を向上させるために、よく使用するビデオファイルを SSD に配置することをおすすめします。
• 🔄 複数の大きなファイルを同時に分析しないでください。

🤝 コントリビューション

コードの貢献を歓迎します！以下の手順に従ってください。

1. このリポジトリを Fork します。
2. 機能ブランチを作成します (git checkout -b feature/AmazingFeature)。
3. 変更をコミットします (git commit -m 'Add some AmazingFeature')。
4. ブランチにプッシュします (git push origin feature/AmazingFeature)。
5. Pull Request を作成します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています - 詳細については LICENSE ファイルを参照してください。

🔗 関連リンク

• Model Context Protocol
• Claude Desktop
• FFmpeg 公式サイト

📞 連絡先

問題や提案がある場合は、以下の方法で連絡してください。

微信: pickstar_loveXX

⭐ このプロジェクトが役に立った場合は、Star をしていただけると幸いです！