Adobe Premiere Pro 用 MCP ブリッジ

MCP を通じてローカルの Adobe Premiere Pro プロジェクトを操作します。

Codex、Claude Code、Claude Desktop、その他の MCP クライアント向けの 284 のツール、13 のコンテキストリソース、10 のガイド付きプロンプトを備えています。CEP が編集を処理し、オプションの UXP ヘルパーが Premiere の音声テキスト変換トランスクリプトを読み取ります。

言語: English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ

はじめに: ローカルブリッジをインストールして Premiere で開き、編集前に verify_premiere_connection を実行してください。

インストール | Codex プラグイン | Claude Code プラグイン | 検証 | プライバシーポリシー | 利用規約 | セキュリティ

インストール

サポートされているブリッジは、同梱の CEP パネルです。Premiere Pro と同じコンピューターに npm パッケージと MCP クライアントをインストールします:

npm install -g @compimprove/adobe-premiere-mcp
premiere-pro-mcp --install-cep
premiere-pro-mcp --doctor

--install-cep は CEP ブリッジをインストールし、必要な Adobe CEP デバッグ設定を有効にし、ブリッジディレクトリを準備し、サポートされているローカル MCP クライアントを設定します。--doctor はサーバービルド、CEP インストール、ブリッジディレクトリ、デバッグ設定、クライアント設定を検証します。

次に Premiere Pro を再起動し、ウィンドウ > 拡張機能 > MCP Bridge (CEP) を開き、インストーラーで表示されたブリッジディレクトリを設定して、ブリッジを起動します。

要件:

• Node.js 20 以降

• Adobe Premiere Pro 2020 以降

• Premiere Pro、MCP クライアント、このパッケージが同じコンピューター上にあること

同梱の uxp-plugin は、Premiere 25.6 以降向けの独立したトランスクリプトヘルパーです。これは CEP 編集ブリッジを置き換えるものではなく、CLI からはまだインストールされません。

Codex プラグイン

このリポジトリのクローンから、MCP 設定と Premiere 編集スキルをバンドルする Codex プラグインをインストールします:

codex plugin marketplace add .
codex plugin add premiere-pro-mcp@adobe-premiere-pro-mcp

このプラグインには、ローカルの CEP ブリッジが引き続き必要です。premiere-pro-mcp --install-cep を実行し、Premiere を再起動して、ウィンドウ > 拡張機能 > MCP Bridge (CEP) を起動し、Codex に get_capabilities とそれに続いて verify_premiere_connection を実行するよう依頼します。

Claude Code プラグイン

このリポジトリのクローンから:

/plugin marketplace add .
/plugin install premiere-pro-mcp@adobe-premiere-pro-mcp

プラグインを使用する前に、上記と同じ手順で CEP ブリッジをインストールして起動します。

Claude Desktop ワンクリックバンドル

各 GitHub リリースには、Claude Desktop 用の .mcpb バンドルが含まれています。一致する adobe-premiere-pro-mcp-<version>.mcpb アセットをダウンロードし、Claude Desktop で開いてローカル MCP サーバーをインストールします。初回起動時に、バンドルされた CEP ブリッジが現在のユーザー用にインストールされます。

Premiere Pro を再起動し、ウィンドウ > 拡張機能 > MCP Bridge (CEP) を開き、ブリッジディレクトリを設定して、ブリッジを起動します。次に Claude に依頼します:

verify_premiere_connection を実行してください。変更は加えないでください。

MCPB バンドルは署名されていません。このリポジトリの GitHub Releases からのみインストールしてください。CEP リリースアーカイブは、署名なしまたは自己署名として正確にラベル付けされています。自己署名は Adobe Marketplace の信頼済みを意味するものではありません。

MCP クライアント設定

インストーラーは、macOS では Claude Desktop を、Windows では VS Code の Claude Desktop と GitHub Copilot を設定します。他の MCP クライアントの場合は、以下を実行するように設定します:

{
  "mcpServers": {
    "premiere-pro": {
      "command": "premiere-pro-mcp"
    }
  }
}

ソースからのインストール

MCP の開発、CEP パネルの変更、またはパッケージインストールのトラブルシューティングを行う場合は、ソースセットアップを使用します:

git clone https://github.com/compimprove/adobe-premiere-mcp.git
cd adobe-premiere-mcp
npm install
npm run build
npm run setup:mac # macOS

Windows では、npm install と npm run build の後に PowerShell から npm run setup:win を使用します。

Premiere Pro 内の現在の CEP パネル UI。更新されたブリッジコントロールとステータスレイアウトを使用しています。

Related MCP server: Premiere Pro MCP Server

現在のステータス

このリポジトリは現在、以下で検証されています:

• macOS

• GitHub Actions による Windows インストーラー設定のスモークチェック

• Adobe Premiere Pro 2020 以降（Premiere Pro 26.0 で積極的に使用・テスト済み）

• Node.js 20 以降

• 最新のステートレスプロトコル検出を備えた MCP v2 サーバートランスポート

• Claude Desktop 用の同梱 macOS インストーラーパス

• VS Code の GitHub Copilot と Claude Desktop 設定用の同梱 Windows インストーラーパス

• Codex、Claude Code、および同様の MCP クライアント向けの手動 MCP 登録

2026 年 8 月 5 日時点の現在のカタログステータス:

• AI 駆動のビデオ編集用に 284 の MCP ツールが公開されています

• プロジェクト設定、メディアの取り込み、ビン、シーケンス、タイムライン編集、トランジション、エフェクト、キーフレーム、キャプション、マーカー、メタデータ、プロキシ、マルチカム、カラー、オーディオ、書き出し、高レベルのアセンブリワークフローをカバーしています

• カタログには、プロダクトスポットのアセンブリ、モーショングラフィックスのデモ、タイムラインのレザリング、キャプションの読み取り、オーディオダッキング、シーン編集検出、EDL インポート、書き出し準備の検証、リンクされたオーディオ/ビデオ操作などの実用的なエージェントワークフローが含まれています

最新のローカルライブ検証:

• 284 のアクティブなツールが公開されています。get_capabilities はローカルインストールとオプションのライブ接続状態を報告し、verify_premiere_connection は正規の読み取り専用ブリッジおよびホスト準備完了チェックです

• 停止中またはプレースホルダーのツールは 0 個のみがアドバタイズされています

• import_ae_comps は、この環境の実際の .aep フィクスチャで Premiere が false を返し、一般的な .aep インポートが CEP ブリッジをフリーズさせる可能性があるため、意図的にアドバタイズされていません

完全なライブスイープ出力は、検証ツールを実行すると /tmp/premiere-mcp-bridge/live-tool-sweep.json に書き込まれます。

含まれるもの

このサーバーは、プロジェクト操作、取り込み、シーケンス作成、タイムライン編集、トランジション、エフェクト、キーフレーム、メタデータ、書き出し、高レベルのアセンブリワークフローをカバーしています。

プロンプトの例:

• "すべてのシーケンスを一覧表示して、どれがアクティブか教えてください。"

• "この 3 つのショットをインポートして、ラフなプロダクトスポットを作成してください。"

• "ビデオトラック 1 のすべてのカットにクロスディゾルブを追加してください。"

• "中央のクリップにガウスぼかしを適用してください。"

• "アクティブなショートフォームクリップに 白黒 エフェクトを適用してください。"

• "インタビューシーケンスを 12.5 秒ですべてのオーディオトラックとビデオトラックにわたってレザーで切り分けてください。"

• "アクティブなシーケンスを FCP XML として書き出してください。"

モノクロのルックには、一般的な彩度のみの調整で白黒を強制するのではなく、白黒 の apply_effect を使用することをお勧めします。

編集する前に、premiere://config/get_instructions リソースをアタッチして、Premiere 固有の操作ガイダンスをモデルに与えることもできます。

セッションの予測可能な開始のために、最初に verify_premiere_connection を実行してください。これにより、CEP ブリッジが応答したことが確認され、プロジェクトを変更せずに Premiere のビルド、開いているプロジェクト、アクティブなシーケンスが返されます。

含まれる高レベルのワークフローツール:

• build_motion_graphics_demo

• assemble_product_spot

• build_brand_spot_from_mogrt_and_assets

assemble_product_spot と build_brand_spot_from_mogrt_and_assets は、オプションの clipPlan 引数をサポートするようになりました。これにより、LLM が固定のテンプレートデフォルトに依存する代わりに、クリップごとのタイミング、トラック配置、トランジション、モーション、トリム、エフェクト、カラー調整を指示できます。

エージェントスキル

Codex、Claude Code、または別のエージェントにインストール、検証、日常的な使用法を正しく処理させるには、同梱の Agent Skill をインストールします:

npx skills add compimprove/adobe-premiere-mcp --skill premiere-pro-mcp

または、スキルパスから直接インストールします:

npx skills add https://github.com/compimprove/adobe-premiere-mcp/tree/main/skills/premiere-pro-mcp

このスキルは、エージェントに MCP のインストール方法、CEP ブリッジの起動と検証方法、Premiere ツールの安全な使用方法、編集前の実際のメディアのインポート、シーケンス認識操作の優先、障害発生時の診断の実行方法を教えます。

詳細設定と検証

ソースインストール、クライアント固有の MCP 設定、Windows インストーラーフラグ、診断、ライブツールスイープについては、QUICKSTART.md を参照してください。これが正規のセットアップガイドであり、このページは製品の選択と使用に焦点を当てています。

簡単な手順:

1. npm install -g @compimprove/adobe-premiere-mcp でインストールし、premiere-pro-mcp --install-cep を実行します。

2. Premiere Pro と MCP クライアントを再起動し、ウィンドウ > 拡張機能 > MCP Bridge (CEP) を起動します。

3. premiere-pro-mcp --doctor を実行し、クライアントに変更を加えずに verify_premiere_connection を呼び出すよう依頼します。

任意の MCP クライアントに手動登録するには、npm インストール後にグローバルコマンドを使用します:

{
  "mcpServers": {
    "premiere-pro": {
      "command": "premiere-pro-mcp"
    }
  }
}

CEP は編集ブリッジのままです。Premiere で拡張機能が表示されない場合は、Premiere の環境設定で UXP プラグイン > 開発者モードを有効にする をオンにし、Premiere を再起動して、CEP パネルを開き直します。個別の UXP パネルは、音声テキスト変換トランスクリプトの読み取りにのみ必要です。

実際のホストスイープでは、使い捨ての Premiere プロジェクトを使用し、node scripts/live-tool-sweep.mjs を実行します。これにより、現在のプロジェクトに一時的な Sweep ... シーケンスが作成されます。

オプションのトランスクリプトブリッジを有効にするソースインストールでは、セットアップは次の処理も行います:

• 依存関係をインストールする

• dist/index.js をビルドする

• Adobe CEP デバッグモードを有効にする

• MCP Bridge (CEP) 拡張機能をインストールする

• /tmp/premiere-mcp-bridge を作成する

• UXP トランスクリプトコマンドキューを準備する

• Claude Desktop に premiere-pro MCP エントリを追加する

重要:

• MCP Bridge (CEP) は、既存の編集ツールでサポートされているブリッジのままです

• MCP Transcript Bridge (UXP) は、read_sequence_transcription でのみ使用されるオプションのヘルパーです

• インストーラーは Adobe CEP デバッグモードを自動的に有効にします

• お使いのマシンで Premiere で拡張機能が正しく表示されない場合は、ブリッジパネルを開く前に Premiere Pro の環境設定で UXP プラグイン > 開発者モードを有効にする をオンにしてください

• npm run setup:mac は、Claude Desktop の設定を自動的に更新するため、macOS で Claude Desktop を使用する場合の最も簡単な方法です

インストーラーの完了後:

1. MCP クライアントが起動時に設定を読み取る場合は、終了して開き直します。インストーラーを使用した場合は、Claude Desktop が対象です。

2. Premiere Pro を終了して開き直します。

3. macOS の Premiere Pro で、Premiere Pro > 環境設定 > プラグイン を開き、UXP プラグイン > 開発者モードを有効にする をオンにします。

4. 設定を変更した場合は、Premiere Pro を再起動します。

5. ウィンドウ > 拡張機能 > MCP Bridge (CEP) を開きます。

6. Temp Directory を /tmp/premiere-mcp-bridge に設定します。

7. 設定を保存 をクリックします。

8. ブリッジを起動 をクリックします。

9. 文字起こしの読み取りを有効にするには、Adobe UXP Developer Tool でリポジトリの uxp-plugin フォルダーを読み込み、ウィンドウ > UXP プラグイン > MCP Transcript Bridge を開きます。

10. UXP パネルで、ブリッジルートとして /tmp/premiere-mcp-bridge を入力し、ブリッジルートを保存 をクリックしてから、ブリッジを起動 をクリックします。

11. 同じ一時ディレクトリを使用して、Codex、Claude Code、Claude Desktop、または別の MCP クライアントから接続します。

12. CEP コマンドが失敗する場合は、診断の実行 をクリックし、/tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json を送り返してください。

開発者モードの切り替えの視覚的な参考が必要な場合は、次のようになります:

ブリッジを起動 後にパネルが Premiere の準備ができたと報告した場合、ブリッジは稼働しています。

クライアント別のインストール

Claude Desktop

macOS では、次を使用します:

npm run setup:mac

これは、MCP エントリを自動的に書き込むこのリポジトリで唯一のパスです。

Codex

最初にサーバーをビルドします:

npm install
npm run build

次に、MCP サーバーを 1 行で追加します:

codex mcp add premiere_pro --env PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge -- node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js

Claude Code

同じ方法でサーバーをビルドします:

npm install
npm run build

次に、同じビルド済みのdist/index.jsエントリポイントと同じ一時ディレクトリを使用して、Claude CodeにMCPサーバーを登録します：

command: node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js
env: PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge

ヘルパーコマンドの代わりにローカルのMCP設定ファイルを使用する場合は、同じdist/index.jsを指定し、同じ環境変数を設定します。

その他のMCPクライアント

Claude Codeと同じ手動登録アプローチを使用します：

command: node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js
env: PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge

すべての手動クライアント設定で重要な点：

• コマンドは1行にまとめる

• dist/index.jsへの実際の絶対パスを使用する

• MCPエントリを追加または更新した後はクライアントを再起動する

• Premiere内でCEPブリッジを起動し、一時ディレクトリが正確に/tmp/premiere-mcp-bridgeであることを確認する

• read_sequence_transcriptionの場合は、同じルートフォルダでUXPトランスクリプトブリッジも起動する

インストールの検証

組み込みのチェックを実行します：

npm run setup:doctor

これにより以下が検証されます：

• Node.jsのバージョン

• ビルド済みサーバー出力

• CEP拡張機能のインストール

• /tmp/premiere-mcp-bridge

• Adobe CEPデバッグモード

• インストーラーパスを使用する場合のClaude Desktop設定エントリ

• /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.jsonに書き込まれるCEPパネルの診断情報

• オプションのヘルパー実行中に/tmp/premiere-mcp-bridge/uxp/status.jsonに書き込まれるUXPトランスクリプトヘルパーのハートビート

より詳細なエンドツーエンドのチェックには、使い捨てのPremiereプロジェクトを使用して次を実行します：

node scripts/live-tool-sweep.mjs

これにより、現在開いているプロジェクトに一時的なSweep ...シーケンスが作成され、実際のデータに対してツールチェーンがテストされます。

ブリッジの仕組み

+-----------+        +-----------+        +-----------+
|  Client   |  MCP   | Node.js   | Files  | CEP Panel |
| (Codex+)  |<------>| MCP Server|<------>| edits     |
+-----------+        +-----------+        +-----------+
                                  |
                                  | Files: uxp/commands + uxp/responses
                                  v
                           +-----------+
                           | UXP panel |
                           | transcripts|
                           +-----------+

1. クライアントがMCPツールを呼び出します。

2. 既存の編集ツールがExtendScriptを生成し、CEPパネルのコマンドファイルを使用します。

3. read_sequence_transcriptionがバージョン付きUXPリクエストをuxp/commandsに書き込みます。

4. UXPパネルがPremiereのUXP APIを通じてソースクリップの音声テキスト変換トランスクリプトを読み取り、正規化されたレスポンスをuxp/responsesに書き込みます。

5. サーバーが構造化JSONをMCPクライアントに返します。CEPとUXPは互いに通信しません。

ツール

284個の宣伝されているツールはすべて実装済みです。ツールスキーマはMCPディスカバリを通じて利用可能です。このカタログは編集サーフェスを人間が読める形で説明したものです。verify_premiere_connectionから始め、エージェントにプロジェクトを変更させる前にプロジェクトを検査してください。

ディスカバリとプロジェクト検査

カタログの対象範囲：

• ディスカバリとプロジェクト検査

• プロジェクトとシーケンス管理

• メディアのインポートとビン管理

• タイムライン配置とクリップ操作

• エフェクト、トランジション、カラー、キーフレーム

• マーカー、メタデータ、ラベル、ワークエリア制御

• 書き出しとインターチェンジヘルパー

• MOGRT、キャプション、プロキシ、再リンクヘルパー

• 音声テキスト変換トランスクリプトの読み取り（オプションのUXPヘルパーを使用するPremiere 25.6以降）

• 高レベルな広告・プロモアセンブリワークフロー

プロジェクト、メディア、ビン

シーケンスとトラック

タイムライン編集とトリム操作

エフェクト、カラー、モーション、キーフレーム

オーディオ、トランジション、キャプション

マーカー、選択、ナビゲーション、再生

書き出し、インターチェンジ、メディア管理

グラフィックス、ワークフロー、ワークスペース、および高度な操作

その他のサポートされている操作

残りのカタログは、メディアプロパティ、プロジェクト設定、表示形式、アンチエイリアス、ポスターフレーム、カラーラベル、選択、トラックターゲティング、プロジェクトパス、プロジェクト数の低レベルの制御をカバーしています。これには、set_override_frame_rate、set_override_pixel_aspect_ratio、set_frame_blend、set_time_interpolation、set_poster_frame、set_anti_alias_quality、set_uniform_scale、set_scale_width_height、set_sequence_display_format、set_project_scratch_disk、get_project_scratch_disks、get_all_project_paths、get_total_clip_count、get_insertion_bin、is_work_area_enabled、match_frame が含まれます。

各ツールの正確な入力スキーマと戻り値の構造については、クライアントで MCP イントロスペクションを使用してください。エージェントは、複数ステップの編集を続行する前に、まず検査し、焦点を絞った変更を行い、影響を受けた状態を読み戻す必要があります。

実際の制限事項

• 自己署名の CEP .zxp はアーカイブの整合性を確認しますが、Adobe Marketplace の承認や公開トラストの保証ではありません。再現可能な署名ワークフローには、プライベート証明書のシークレットとターゲットプラットフォームでの Premiere 検証が必要です。

このプロジェクトは元のプロトタイプよりもはるかに使いやすくなっていますが、魔法ではありません。

• Premiere のスクリプティングでは、依然としてすべての UI 操作をきれいに公開できていません。

• キャプショントラックは Speech-to-Text の文字起こしとは異なります。read_sequence_captions は CEP 経由では引き続き利用できませんが、read_sequence_transcription は UXP 経由でソースクリップの文字起こしを読み取ります。

• プロフェッショナルなタイトルデザインは、依然として実際の MOGRT アセットまたは外部グラフィックスワークフローに依存しています。

• get_render_queue_status は、Adobe Media Encoder の統合が利用可能な場合にのみ役立ちます。

• 最良の結果は、実際のソース映像、実際のオーディオ、実際のブランドアセットから得られます。自動化レイヤーはこれらを組み立てて操作しますが、編集上の判断を置き換えるものではありません。

トラブルシューティング

ツールは表示されるが呼び出しが失敗する場合:

1. Premiere Pro が開いており、プロジェクトが読み込まれていることを確認します。

2. Window > Extensions > MCP Bridge (CEP) を開きます。

3. 一時ディレクトリが正確に /tmp/premiere-mcp-bridge であることを確認します。

4. Start Bridge をクリックします。

5. ブリッジコードを更新した場合は、パネルを右クリックして Reload を選択します。

6. コマンドを再試行します。

read_sequence_transcription が UXP ブリッジが利用できないと報告する場合:

1. Premiere Pro 25.6 以降を使用します。

2. Plugins > Enable Developer Mode を有効にして、Adobe UXP Developer Tool で uxp-plugin を読み込みます。

3. Window > UXP Plugins > MCP Transcript Bridge を開きます。

4. /tmp/premiere-mcp-bridge を入力し、Save bridge root をクリックしてから Start Bridge をクリックします。

5. シーケンス内のソースクリップが Premiere の Text パネルで文字起こしされていることを確認します。一部のソースクリップに文字起こしがない場合、ツールは部分的な結果を返します。

MCP クライアントがサーバーを見つけられない場合:

1. dist/index.js への絶対パスを確認します。

2. PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge を確認します。

3. 設定を変更した後、MCP クライアントを再起動します。

4. npm run setup:doctor を実行します。

開発者向けノート

便利なコマンド:

npm run build
npm test -- --runInBand
npm run setup:doctor
node scripts/live-tool-sweep.mjs

参照:

• 最短のインストール手順は QUICKSTART.md

• 現在の制限事項は KNOWN_ISSUES.md

• 開発ワークフローは CONTRIBUTING.md