Video Editor (FFMpeg)

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

このサーバーは強力なビデオエディット機能を備え、自然言語コマンドを使ってFFmpegを介したビデオエディット操作を実行します。

✨ 主な機能

ツール

サーバーは主なツールを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"]
    }
  }
}

💻 使用例

基本的な使用法

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. 完了したらフィードバックを提供します。

🔧 開発

ビルドと公開

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

📚 エラー処理

サーバーは強力なエラー処理機能を備えており、以下の問題に対応します。

• 無効な入力ファイル
• 形式が誤ったFFmpegコマンド
• 実行時のエラー
• 進捗追跡の問題

すべてのエラーはクライアントに詳細に報告され、デバッグに役立ちます。

🛡️ セキュリティに関する注意事項

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

🤝 貢献

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

1. このリポジトリをForkします。
2. 新しいブランチを作成します：git checkout -b feature/your-feature
3. 変更をコミットします：git commit -m '変更内容の説明'
4. リモートリポジトリにプッシュします：git push origin feature/your-feature
5. Pull Requestを作成します。

コミットする前に、コードの形式とドキュメントが要件を満たしていることを確認してください。