Adobe Premiere Pro MCP

🚀 MCP Adobe Premiere Pro — AIによるビデオ編集自動化

AIとPremiere Proの融合。Model Context Protocol (MCP) を搭載したClaudeや他のAIエージェントを使って、自然言語で編集操作をコントロールし、ワークフローを自動化します。

✨ このプロジェクトとは？

このプロジェクトは、Adobe Premiere Pro用のAIベースの自動化ブリッジです。（MCPを介して）一連の編集ツールを公開することで、以下のことが可能になります。

• 🗣️ エディターと会話する（Claudeや他のAIエージェントを介して）
• ⚡ 繰り返し作業を自動化する
• 🧠 より賢く、コンテキストを考慮したワークフローを構築する

🧩 UXP DevToolsを使用する場合（実験的）

このプロジェクトをPremiere Pro (24.4以上) のUXPパネルとして使用することもできます。

1. Adobe UXP DevTools を開きます。
2. 「Add Plugin」をクリックし、uxp-plugin/ フォルダを選択します。
3. DevToolsでパネルを起動し、Premiere Proで Window > Plugins > MCP Bridge (UXP) から開きます。

⚠️ 重要な注意

• Premiere ProでのUXPスクリプトは実験的で制限があります。タイムラインやシーケンスの編集など、一部の機能はまだ利用できない場合があります。
• 完全な自動化には、CEP（レガシー）パネルを使用してください。

🛠️ サポートされるツール

📁 プロジェクト管理

• create_project — 新しいPremiere Proプロジェクトを作成します。
• open_project — 既存のプロジェクトファイルを開きます。
• save_project — 現在のプロジェクトを保存します。
• save_project_as — 新しい名前や場所でプロジェクトを保存します。

📂 メディア管理

• import_media — メディアファイル（ビデオ、オーディオ、画像）をインポートします。
• import_folder — フォルダ内のすべてのメディアファイルをインポートします。
• create_bin — プロジェクトパネルに新しいビン（フォルダ）を作成します。

🎬 シーケンス管理

• create_sequence — 新しいシーケンス（タイムライン）を作成します。
• duplicate_sequence — 既存のシーケンスを複製します。
• delete_sequence — シーケンスを削除します。

⏱️ タイムライン操作

• add_to_timeline — メディアクリップをシーケンスのタイムラインに追加します。
• remove_from_timeline — タイムラインからクリップを削除します。
• move_clip — クリップを別の位置に移動します。
• trim_clip — クリップのイン/アウトポイントを調整します。
• split_clip — 特定の時点でクリップを分割します。

🎨 エフェクトとトランジション

• apply_effect — クリップにビジュアルまたはオーディオエフェクトを適用します。
• remove_effect — クリップからエフェクトを削除します。
• add_transition — 2つのクリップ間にトランジションを追加します。
• add_transition_to_clip — クリップの開始または終了位置にトランジションを追加します。

🔊 オーディオ操作

• adjust_audio_levels — オーディオクリップの音量を調整します。
• add_audio_keyframes — オーディオレベルにキーフレームを追加します。
• mute_track — オーディオトラック全体をミュートまたはミュート解除します。

🎛️ 色補正

• color_correct — 基本的な色補正調整を適用します。
• apply_lut — クリップにルックアップテーブル（LUT）を適用します。

📤 エクスポートとレンダリング

• export_sequence — シーケンスをレンダリングしてビデオファイルとしてエクスポートします。
• export_frame — 単一のフレームを画像としてエクスポートします。

🎥 高度な機能

• create_multicam_sequence — 複数のビデオクリップからマルチカメラシーケンスを作成します。
• create_proxy_media — メディアのプロキシバージョンを生成します。
• auto_edit_to_music — ビデオを音楽のビートに合わせて自動編集します。
• stabilize_clip — ビデオの安定化を適用します。
• speed_change — クリップの再生速度を変更します。

🔍 プロジェクト/メディア/シーケンスの探索

• list_project_items — プロジェクト内のすべてのメディアアイテム、ビン、アセットをリストします。
• list_sequences — プロジェクト内のすべてのシーケンスをリストします。
• list_sequence_tracks — シーケンス内のすべてのトラックをリストします。
• get_project_info — 包括的なプロジェクト情報を取得します。

⚠️ 動作しない機能とその理由

❌ サポートされない機能（Adobeスクリプティングの制限）

• add_text_overlay — テキストオーバーレイ（レガシータイトル）は、最新のPremiere Proスクリプティングでは非推奨または動作しません。
• add_shape — 形状/グラフィックオーバーレイは、Premiereスクリプティングではサポートされていません。
• Essential Graphics (MOGRTs) — スクリプト化できません。
• Direct pixel manipulation — 不可能です。

理由：AdobeがこれらのスクリプティングAPIを削除または非推奨にしています。上記の機能のみが確実にスクリプト化できます。

🚦 クイックスタート

1. クローンとインストール

git clone https://github.com/hetpatel-11/Adobe_Premiere_Pro_MCP
cd MCP_Adobe_Premiere_Pro
npm install

2. MCPサーバーのビルドと起動

npm run build
npm start

3. Premiere ProへのCEP拡張機能のインストール

1. PremiereRemote 拡張機能フォルダをコピーして、Adobe CEP拡張機能ディレクトリに貼り付けます。
   • macOS: ~/Library/Application Support/Adobe/CEP/extensions/
   • Windows: %APPDATA%/Adobe/CEP/extensions/
2. 署名されていない拡張機能の読み込みを有効にします。
   • macOS: ~/Library/Preferences/com.adobe.CSXS.9.plist を編集し、PlayerDebugMode を 1 に設定します。
   • Windows: regedit を使用して、HKEY_CURRENT_USER/Software/Adobe/CSXS.9 の下で PlayerDebugMode を 1 に設定します。
   • CEP Debugging Guide
3. Premiere Proを再起動します。
4. 拡張機能を開きます。
   • Window > Extensions (Legacy) > PremiereRemote に移動します。
   • ブリッジが実行中の場合、パネルに「Ready!」と表示されます。

4. Claude（または他のAIエージェント）の接続

• Claudeを設定して、MCPサーバーをツールエンドポイントとして使用します。
• Claudeに編集タスクを実行するように依頼します（上記のサポート機能を参照）。

🐞 既知の問題と制限

• テキスト/グラフィックオーバーレイは動作しません（上記を参照）
• 一部のスクリプティングAPIはバグがあるか、バージョンに依存します
• CEP拡張機能は最新のAdobeアプリでは非推奨です（ただし、現時点ではまだ動作します）
• UXPスクリプティングはPremiere Proでは実験的で制限があります（上記を参照）
• エラーハンドリングは堅牢ですが、Premiereスクリプティングの特性により、一部の失敗は無音で終わる場合があります
• これは概念実証/出発点です — 完成度の高い商用製品ではありません。

💡 このプロジェクトが存在する理由

私は、Premiere ProにおけるAIベースのビデオ編集自動化がどこまで可能かを調べたかったです。実際の制限はありますが、このプロジェクトは以下のことに最適な出発点です。

• 繰り返しの編集作業を自動化する
• より賢いAIワークフローを構築する
• Adobeスクリプティングで可能なことの限界を探求する

もっと高度な機能（例：高度なグラフィック/テキスト）が必要な場合は、After Effectsスクリプティング、Photoshop、またはサードパーティプラグインが必要になります。

📚 参考文献

• Adobe Premiere Pro Scripting Guide
• Adobe CEP Resources

🙏 謝辞とコントリビューション

このプロジェクトが役に立ったと感じた場合や、コントリビュートしたい場合は、自由にIssueやPRを開いてください。率直なフィードバックと改善案を歓迎します！