Video Editor MCP Server

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

このサーバーは、FFmpegを利用して自然言語コマンドでビデオエディット操作を実行する強力なビデオエディットMCPサーバーです。

✨ 主な機能

ツール

このサーバーは、主なツールを1つ実装しています。

• execute_ffmpeg：進捗追跡付きでFFmpegコマンドを実行します。
  • 入力コマンド文字列を受け取ります。
  • FFmpeg操作を検証して実行します。
  • リアルタイムの処理進捗を報告します。
  • エラーを処理し、詳細なフィードバックを提供します。
  • 以下を含むすべてのFFmpeg操作をサポートします。
    • クロップ/カット
    • ビデオの結合
    • 形式の変換
    • 速度の調整
    • オーディオトラックの追加
    • オーディオの抽出
    • 字幕の追加
    • 基本的なフィルター（明度、コントラストなど）

📦 インストール

前提条件

1. FFmpegがインストールされ、システムのPATHに含まれている必要があります。
2. Python 3.9以上が必要です。
3. 必要なPythonパッケージ：

   mcp
   httpx
   

インストール手順

1. FFmpegがインストールされていない場合は、以下のコマンドでインストールします。

   # macOSでHomebrewを使用する場合
   brew install ffmpeg
   
   # WindowsでChocolateyを使用する場合
   choco install ffmpeg
   
   # Ubuntu/Debianでの場合
   sudo apt install ffmpeg
   

2. ビデオエディットパッケージをインストールします。

   uv add video-editor
   

Claudeデスクトップの統合

Claude Desktopの設定ファイルで設定を行います。

MacOSの場合：~/Library/Application Support/Claude/claude_desktop_config.json Windowsの場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "video-editor": {
      "command": "uv",
      "args": ["run", "video-editor"]
    }
  }
}

🔧 開発

ビルドと公開

1. 依存関係を同期します。

   uv sync
   

2. パッケージをビルドします。

   uv build
   

3. PyPIに公開します。

   uv publish
   

注意：PyPIの認証情報は以下の方法で設定します。

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名/パスワード：--username/UV_PUBLISH_USERNAME および --password/UV_PUBLISH_PASSWORD

デバッグ

MCPインスペクターを使用して、最適なデバッグ体験を得ることができます。

npx @modelcontextprotocol/inspector uv --directory /path/to/video_editor run video-editor

💻 使用例

基本的な使用法

Claude Desktopに接続したら、以下のように自然言語でリクエストを行うことができます。

1. "video.mp4を1:30から2:45までクロップする"
2. "input.mp4をWebM形式に変換する"
3. "video.mp4を2倍速にする"
4. "video1.mp4とvideo2.mp4を結合する"
5. "video.mp4からオーディオを抽出する"
6. "video.mp4にsubtitles.srtを追加する"

サーバーは以下の処理を行います。

1. リクエストを解析します。
2. 適切なFFmpegコマンドを生成します。
3. コマンドを実行し、進捗を追跡します。
4. 完了時にフィードバックを提供します。

エラー処理

サーバーには堅牢なエラー処理機能が備わっており、以下のエラーを含むすべてのエラーが詳細にクライアントに報告され、デバッグに役立ちます。

• 入力ファイルが無効な場合
• FFmpegコマンドの形式が正しくない場合
• 実行時にエラーが発生した場合
• 進捗追跡に問題がある場合

セキュリティ上の注意事項

• 明確に許可されたディレクトリ内のファイルのみを処理します。
• FFmpegコマンドを実行する前に検証します。
• すべての入力パラメーターをクリーンアップします。
• セキュリティ関連の問題に関する詳細なエラーメッセージを報告します。

コントリビューション

このプロジェクトへのコントリビューションを歓迎します！詳細については、コントリビューションガイド をご覧ください。

📄 ライセンス

このプロジェクトは MIT License の下で保護されています。