Video Editor MCP server

Video Editor MCP サーバー

デモはこちらでご覧いただけます：https://www.youtube.com/watch?v=KG6TMLD8GmA

お気に入りの LLM と Video Jungle を使って、動画のアップロード、編集、検索、生成を行えます。

このツールを使用するには、Video Jungle でアカウントを登録し、API キーを追加する必要があります。

コンポーネント

リソース

このサーバーは、以下の機能を使って動画をアップロード、生成、編集するためのインターフェースを実装しています。

• 個々の動画やプロジェクトにアクセスするためのカスタム vj:// URI スキーム
• 各プロジェクトのリソースには、名前と説明があります
• 検索結果には、動画の内容とそのタイミングに関するメタデータが含まれるため、編集を直接生成できます

プロンプト

近日公開予定です。

ツール

このサーバーには、いくつかのツールが実装されています。

• add-video
  • URL から分析用の動画ファイルを追加します。動画ファイルを参照するための vj:// URI を返します
• create-videojungle-project
  • 動画編集の生成に使用する生成スクリプト、分析済み動画、画像を格納する Video Jungle プロジェクトを作成します
• edit-locally
  • OpenTimelineIO プロジェクトを作成し、マシンにダウンロードして Davinci Resolve Studio のインスタンスで開きます（このツールを呼び出す前に、Resolve Studio がすでに起動している必要があります。）
• generate-edit-from-videos
  • 複数の動画ファイルからレンダリング済みの動画編集を生成します
• generate-edit-from-single-video
  • 1 つの入力動画ファイルから編集を生成します
• get-project-assets
  • 動画編集の生成に使用する、プロジェクト内のアセットを取得します。
• search-videos
  • 埋め込みとキーワードに基づいて動画の一致候補を返します
• update-video-edit
  • 動画編集の情報をリアルタイムで更新します。Video Jungle が開いている場合、編集内容はリアルタイムで更新されます。

実際にツールを使う

ツールを使用するには、Video Jungle に登録して API キーを追加する必要があります。

add-video

add-video ツールを呼び出すプロンプトの例を示します。

can you download the video at https://www.youtube.com/shorts/RumgYaH5XYw and name it fly traps?

これにより、URL から動画がダウンロードされ、ライブラリに追加され、後で検索できるように分析されます。分析はマルチモーダルで行われるため、音声と映像の両方を検索できます。

search-videos

動画のダウンロードと分析が完了すると、search-videos ツールを使って動画を検索できます。

can you search my videos for fly traps?

検索結果には、最初の分析で判明した詳細に基づいて動画編集を生成するための関連メタデータが含まれます。

search-local-videos

このツールを使用するには、環境変数 LOAD_PHOTOS_DB=1 を設定する必要があります。これにより、Claude がローカルマシン上のファイルへのアクセスを求めるようになります。

設定すると、Apple のタグを使って、Photos アプリ内にあるスマートフォン上の動画を検索できます。

私の場合、「Skateboard」を検索すると、動画ファイルが 1903 件見つかります。

can you search my local video files for Skateboard?

generate-edit-from-videos

最後に、これらの検索結果を使って編集を生成できます。

can you create an edit of all the times the video says "fly trap"?

（現時点では）、動画編集ツールは現在のチャット内のコンテキストに依存します。

generate-edit-from-single-video

最後に、既存の動画 1 本から編集内容を切り出すことができます。

can you create an edit of all the times this video says the word "fly trap"?

設定

Video Jungle settings にログインして、API key を取得する必要があります。その後、これを使って Video Jungle MCP を起動します。

$ uv run video-editor-mcp YOURAPIKEY

この MCP サーバーで MacOS の Photos アプリを検索できるようにするには、次の設定を行います。

$ LOAD_PHOTOS_DB=1 uv run video-editor-mcp YOURAPIKEY

クイックスタート

インストール

Smithery 経由でのインストール

Smithery 経由で Claude Desktop 用の Video Editor を自動的にインストールするには、次の手順を実行します。

npx -y @smithery/cli install video-editor-mcp --client claude

Claude Desktop

claude_desktop_config.json を手動で編集する必要があります。

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

 "mcpServers": {
   "video-editor-mcp": {
     "command": "uvx",
     "args": [
       "video-editor-mcp",
       "YOURAPIKEY"
     ]
   }
 }

 "mcpServers": {
   "video-editor-mcp": {
     "command": "uv",
     "args": [
       "--directory",
       "/Users/YOURDIRECTORY/video-editor-mcp",
       "run",
       "video-editor-mcp",
       "YOURAPIKEY"
     ]
   }
 }

  "video-jungle-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/<PATH_TO>/video-jungle-mcp",
      "run",
      "video-editor-mcp",
      "<YOURAPIKEY>"
    ],
   "env": {
        "LOAD_PHOTOS_DB": "1"
    }
  },

リポジトリを配置したディレクトリに、必ずお使いのコンピューター上のパスを置き換えてください。

開発

ビルドと公開

パッケージを配布できる状態にするには、次の手順を実行します。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージの配布用ファイルをビルドします。

uv build

これにより、dist/ ディレクトリにソース配布物とホイール配布物が作成されます。

3. PyPI に公開します。

uv publish

注：環境変数またはコマンドフラグで PyPI の認証情報を設定する必要があります。

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

MCP サーバーレジストリ

mcp-name: io.github.burningion/video-editing-mcp

デバッグ

MCP サーバーは stdio 経由で実行されるため、デバッグが難しい場合があります。最適なデバッグ体験を得るために、MCP Inspector の使用を強くおすすめします。

次のコマンドを使って、npm から MCP Inspector を起動できます。

（YOURDIRECTORY と YOURAPIKEY は、このリポジトリがあるディレクトリと、設定ページで確認できる Video Jungle API キーに置き換えてください。）

npx @modelcontextprotocol/inspector uv run --directory /Users/YOURDIRECTORY/video-editor-mcp video-editor-mcp YOURAPIKEY

起動すると、Inspector に URL が表示されます。その URL にブラウザーからアクセスすると、デバッグを開始できます。

また、プロジェクトディレクトリ内の app.log にログを出力するようにしています。API 呼び出しを診断するためのログは、次のように追加できます。

logging.info("this is a test log")

プロジェクトの作業を追う方法として、ターミナルセッションを開いて次のコマンドを実行するのがおすすめです。

$ tail -n 90 -f app.log