Video Edit MCP

🚀 ビデオエディットMCPサーバー 🎬

高度なビデオおよびオーディオ編集操作を行うために設計された強力なモデルコンテキストプロトコル（MCP） サーバーです。このサーバーは、Claude DesktopやCursorなどのMCPクライアントが、標準化された統一インターフェイスを通じて包括的なマルチメディア編集タスクを実行できるようにします。

https://github.com/user-attachments/assets/134b8b82-80b1-4678-8930-ab53121b121f

🚀 クイックスタート

このビデオエディットMCPサーバーは、高度なビデオとオーディオ編集操作を可能にする強力なツールです。以下では、その機能やインストール方法、使用例などを説明します。

✨ 主な機能

🎥 ビデオ操作

• 基本編集：ビデオのトリミング、結合、リサイズ、クロップ、回転
• エフェクト：速度制御、フェードイン/アウト、グレースケール、ミラー
• オーバーレイ：透明度を持つテキスト、画像、またはビデオのオーバーレイを追加
• 形式変換：コーデックを制御しながら形式を変換
• フレーム操作：フレームの抽出、画像からのビデオ作成

🎵 オーディオ操作

• オーディオ処理：オーディオの抽出、トリミング、ループ、連結
• 音量制御：レベルの調整、フェードイン/アウトエフェクト
• オーディオミキシング：複数のトラックを混合
• 統合：ビデオにオーディオを追加、サウンドトラックの置き換え

📥 ダウンロードとユーティリティ

• ビデオダウンロード：YouTubeや他のプラットフォームからのダウンロード
• ファイル管理：ディレクトリ操作、ファイルリスト表示
• パス提案：推奨されるダウンロード場所を取得

🧹 メモリとクリーンアップ

• スマートメモリ：中間ファイルを保存せずに操作を連鎖させる
• リソース管理：メモリのクリア、保存されたオブジェクトの確認
• 効率的な処理：複雑なワークフローでオブジェクトをメモリに保持

🔗 操作の連鎖

中間ファイルを作成することなく、複数の操作をシームレスに連鎖させることができます。ビデオを複数のステップ（トリミング → オーディオの追加 → エフェクトの適用 → テキストの追加）で処理しながら、すべてをメモリに保持して最適なパフォーマンスを実現します。

📋 必要条件

• Python 3.10以上
• moviepy==1.0.3
• yt-dlp>=2023.1.6
• mcp>=1.12.2
• typing-extensions>=4.0.0

📦 インストール

Claude Desktop / Cursor MCP統合の場合

uvがインストールされていることを確認してください。
インストールされていない場合は、以下のPowerShellコマンドを使用してインストールします。

powershell -ExecutionPolicy Bypass -Command "irm https://astral.sh/uv/install.ps1 | iex"

この設定をMCP設定ファイルに追加します。

{
  "mcpServers": {
    "video_editing": {
      "command": "uvx",
      "args": [
        "--python",
        "3.11",
        "video-edit-mcp"
      ]
    }
  }
}

設定ファイルの場所：

• Claude Desktop (Windows)：%APPDATA%/Claude/claude_desktop_config.json
• Claude Desktop (macOS)：~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor：プロジェクトルートの.cursor/mcp.json

手動インストール

git clone https://github.com/Aditya2755/video-edit-mcp.git
cd video-edit-mcp
pip install -r requirements.txt
pip install -e .

🏗️ プロジェクト構造

video_edit_mcp/
├── src/
│   └── video_edit_mcp/
│       ├── __init__.py
│       ├── main.py                 # MCPサーバーの実装
│       ├── video_operations.py     # ビデオ編集ツール
│       ├── audio_operations.py     # オーディオ処理ツール
│       ├── download_utils.py       # ダウンロード機能
│       ├── util_tools.py          # メモリとユーティリティツール
│       ├── utils.py               # ユーティリティ関数
│     
├── pyproject.toml                 # プロジェクト設定
├── requirements.txt               # 依存関係
├── uv.lock                        # ロックファイル
├── LICENSE                        # MITライセンス
├── MANIFEST.in                    # マニフェストファイル
└── README.md

💻 使用例

基本的な使用法

# Chain operations without intermediate files
video_info = get_video_info("input.mp4")
trimmed = trim_video("input.mp4", 10, 60, return_path=False)  # Keep in memory
with_audio = add_audio(trimmed, "background.mp3", return_path=False)  
final = add_text_overlay(with_audio, "Hello World", x=100, y=50, return_path=True)

🚀 将来の機能拡張とコントリビューション

以下の魅力的な分野でのコントリビューションを歓迎します。

🤖 AI機能

• 音声文字変換（STT）：自動字幕生成と文字起こし
• 文字音声変換（TTS）：ナレーション用のAI音声合成
• オーディオ強化：AIベースのノイズリダクションとオーディオ品質の向上
• スマートタイムスタンプ：自動シーン検出とチャプター生成
• 顔追跡：高度な顔検出と追跡による自動編集
• 物体認識：検出された物体に基づく追跡と編集
• コンテンツ分析：AIベースのコンテンツ分類とタグ付け

🤝 コントリビュート方法

1. リポジトリをフォークする
2. 機能ブランチを作成する：git checkout -b feature/amazing-feature
3. 変更をコミットする：git commit -m 'Add amazing feature'
4. ブランチにプッシュする：git push origin feature/amazing-feature
5. プルリクエストを作成する

📄 ライセンス

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