ビデオエディターMCPサーバー

FFmpeg を活用して自然言語コマンドを通じてビデオ編集操作を実行する強力なビデオ編集 MCP サーバーです。

コンポーネント

ツール

サーバーは 1 つの主要なツールを実装します。

• execute_ffmpeg : 進捗状況を追跡しながらFFmpegコマンドを実行する

  • コマンド文字列を入力として受け取ります

  • FFmpeg 操作を検証して実行する

  • 処理中の進行状況をリアルタイムで報告します

  • エラーを処理し、詳細なフィードバックを提供します

  • 以下を含むすべての FFmpeg 操作をサポートします:

    • トリミング/カット

    • ビデオの結合

    • フォーマットの変換

    • 速度調整

    • オーディオトラックの追加

    • 音声の抽出

    • 字幕の追加

    • 基本フィルター（明るさ、コントラストなど）

Related MCP server: FFmpeg MCP

構成

前提条件

1. FFmpeg がインストールされ、システム PATH でアクセスできる必要があります。

2. Python 3.9以上

3. 必要な Python パッケージ:

   mcp
   httpx

インストール

1. FFmpeg がまだインストールされていない場合はインストールします。

   # On macOS with Homebrew
   brew install ffmpeg
   
   # On Windows with Chocolatey
   choco install ffmpeg
   
   # On Ubuntu/Debian
   sudo apt install ffmpeg

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

   uv add video-editor

クロードデスクトップ統合

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. 「ビデオ.mp4からオーディオを抽出」

6. 「video.mp4にsubtitles.srtを追加する」

サーバーは次のことを行います。

1. リクエストを解析する

2. 適切なFFmpegコマンドを生成する

3. 進捗状況を追跡しながら実行する

4. 完了時にフィードバックを提供する

エラー処理

サーバーには、次の堅牢なエラー処理機能が含まれています。

• 無効な入力ファイル

• 不正な FFmpeg コマンド

• ランタイム実行エラー

• 進捗状況の追跡に関する問題

すべてのエラーは、デバッグ用の詳細なメッセージとともにクライアントに報告されます。

セキュリティに関する考慮事項

• 明示的に許可されたディレクトリ内のファイルのみを処理します

• 実行前にFFmpegコマンドを検証します

• すべての入力パラメータをサニタイズする

• セキュリティ関連の問題に関する詳細なエラーメッセージを報告します

貢献

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

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. 変更を加える

4. プルリクエストを送信する