Premiere-MCP-IMT + SKILLS — Premiere Pro for AI agents

Premiere-MCP-IMT + SKILLS — AI エージェントのための Premiere Pro

AI アシスタント（Claude Desktop、Cursor、ChatGPT、Google Antigravity、または任意の MCP クライアント）が、起動中の Adobe Premiere Pro 内で作業できます。プロジェクトとシーケンスを読み込み、クリップのカット、トリミング、移動、リップル編集、エフェクト、トランジション、キーフレームの適用、マーカーやキャプションの追加、リフレーム、フレームの確認、書き出しを自然な言葉で指示できます。

Adobe のすべての UI 言語に対応 · 豊富なスキルライブラリ · 生成機能向けに構築。 Premiere-MCP-IMT は、Adobe が提供するすべての UI 言語で動作し、豊富なスキルライブラリを備え、Adobe の生成機能（Generative Extend、Generative Media、Object Mask、Enhance Speech、文字起こしとキャプション、Auto Reframe、Search、AI Assistant）向けに構築されています。

連携して動作する 2 つのパーツ：

• MCP サーバー — 約 440 の Premiere 操作を 9 つのツールで提供します。書き込みは Premiere から読み戻して検証します。すべての Premiere UI 言語に対応（実機で検証済み）。テレメトリーはありません。
• スキル（skills/pr。pr_skill ツールからも提供されるため、どのクライアントでも利用できます）— Premiere を安全に操作する方法、スクリプトでできることの限界、そして Premiere 独自の AI ツール（Generative Extend、Generative Media Tool（動画、効果音、音楽）、Object Mask、Speech to Text と Paper Edit、キャプション、Enhance Speech とステム分離、Search、AI Assistant、Auto Reframe、Scene Edit Detection、Morph Cut）の使い方を解説します。これらを組み合わせるレシピや、注意点も含まれています。

英語だけでなく、ローカライズされた Premiere 向けに構築。 ほとんどの Premiere MCP サーバーやエージェントスキルは英語 UI を前提としているため、ドイツ語、中国語、ロシア語のインストール環境ではエフェクト、トランジション、パラメーター名が一致しなくなります。Premiere-MCP-IMT は matchName でコンポーネントを特定し、Premiere 自身の UI 辞書を通じて英語のエフェクト名、トランジション名、パラメーター名を翻訳するため、同じエージェントと同じスキルが Premiere の全 10 UI 言語で動作します（実機で検証済み）。

Immersive Media Technologies による開発です。

macOS と Windows · Premiere Pro 2024–2026 — macOS（26.5）および Windows 11 ARM（26.5.2、Microsoft Store 版 Claude Desktop）で実機検証済み · Node.js 20.19 以降（Claude Desktop 拡張機能では不要）。

注意

これは実際の Premiere プロジェクトを編集します。また、スクリプトによる取り消しが適用されるのは一部の編集のみです。コピー上で作業してください。プロジェクトの内容（名前、文字起こし、マーカー、フレーム）は、使用する AI サービスに送信されます。Premiere の生成ツールは Adobe クレジットを消費します。エージェントは開始前に確認を求めます。Raw ExtendScript は、有効にしない限りオフになっています。

依頼できること

• 「アクティブなシーケンス内にある、12 フレーム未満のすべてのクリップと、すべてのギャップを一覧表示して。」
• 「このインタビューの間を 3 分の 1 秒まで詰め、カメラが固定されているジャンプカットに Morph Cut を適用して。」 (スキル)
• 「この編集の 9:16 版と 1:1 版を作成して、タイトルが TikTok の UI 領域に重ならないか確認して。」
• 「ショット全体で、左側にいる男性の顔をぼかして。」 (スキル：Object Mask で対象をクリックすれば、あとはエージェントが処理します)
• 「このインタビューの音楽は現地で録音されたものなので、取り除いて、セリフの下に別の音楽を付けて。」 (スキル)
• 「このトラックのすべての拍にマーカーを付けて、拍ごとに 2 拍分のセレクトを並べて。」

エージェントは操作を自ら組み合わせ、各ステップの間にシーケンスを確認します。スキルは、どの Premiere AI ツールが目的に合うか、コストはいくらか、どこでうまくいかなくなるかを伝えます。

インストール

このコンピューターで Premiere Pro を起動しておく必要があります。また、コネクターも必要です。これは Premiere 内で動作し、サーバーとの通信を担う小さな CEP 拡張機能です。エージェントが初回使用時にインストールします（pr_install_connector。最初に確認があり、その後 Premiere を終了して再起動します）。または、以下のインストーラーを使用してください。

クライアント	方法
Claude Desktop	premiere-mcp-imt.mcpb をダウンロードしてダブルクリックし、インストールを選択します（Windows：設定 → 拡張機能にドラッグします）。Node は不要です。
Cursor	Cursor に追加 — ワンクリックで Cursor が開き、設定を書き込みます（または、以下のスニペットを ~/.cursor/mcp.json に追加します）。
Google Antigravity	設定 → カスタマイズ → インストール済み MCP サーバー → 生の設定を表示 → 以下のスニペットを追加します。
ChatGPT（リモートサーバーのみ）	Premiere を実行しているコンピューターで npx -p @immersive-media-technologies/premiere-mcp-imt premiere-mcp-imt-chatgpt を実行します。トンネル経由でサーバーが起動し、ChatGPT に貼り付ける URL が表示されます。
任意の MCP クライアント	以下のスニペットを mcpServers に追加します。

{
  "mcpServers": {
    "premiere": {
      "command": "npx",
      "args": ["-y", "@immersive-media-technologies/premiere-mcp-imt"]
    }
  }
}

ソースからインストールし、ライブセルフテストを実行する方法（こちらが推奨手順です）：

git clone https://github.com/Immersive-Media-Technologies/premiere-mcp-imt.git
cd premiere-mcp-imt && ./install.sh        # Windows: .\install.ps1

インストーラーは Premiere、Node、FFmpeg を確認してビルドし、コネクターをインストールします（最初に確認があります）。次に、起動中の Premiere にコネクターが応答するかどうかを問い合わせ、さらに確認後、Claude Desktop、Cursor、Antigravity の設定にエントリーを書き込み、バックアップを作成します。

接続できない場合

• pr_verify でコネクターが応答しないと表示される場合：コネクターのインストール後に Premiere を完全に終了してから、再度起動してください。開いている Premiere のダイアログも閉じてください（モーダルダイアログがスクリプトの実行をブロックします）。premiere-mcp-imt --diagnose-cep はファイル、デバッグフラグ、Premiere の署名ログを確認します。
• コネクターが署名されていない場合：CEP で未署名の拡張機能を許可する必要があります（CSXS 9–14 では PlayerDebugMode = 1。Windows では HKCU\Software\Adobe\CSXS.<n> の String（REG_SZ）値）。インストーラーがこの設定を行います。
• macOS で spawn npx ENOENT が発生する場合：GUI アプリはシェルの PATH を参照できません。npx の代わりに Homebrew または nodejs.org からインストールした Node の絶対パスを指定してください（nvm の Node は GUI アプリから参照できません）。
• ラウドネス、無音区間（detect_silence）、ビート、シーン変更の分析には FFmpeg が必要です（brew install ffmpeg、winget install Gyan.FFmpeg）。
• Windows で Microsoft Store 版の Claude Desktop を使用している場合：Store アプリからのレジストリ書き込みはサンドボックス化されています。pr_install_connector の後に Premiere がコネクターを読み込まない場合は、ソースチェックアウトから通常の PowerShell を開き、powershell -ExecutionPolicy Bypass -File scripts\install-cep.ps1 を一度実行してください（または install.ps1 を使用してください）。
• premiere-mcp-imt --doctor は、プロジェクトを読み込まずにローカルのインストール状態を確認します。

安全性の仕組み

検証済みの書き込み	編集内容を Premiere から読み戻し、読み戻した内容が一致した場合にのみ verified と報告します。それ以外は未確認として報告します。結果が不明な編集があると、エージェントがプロジェクトを確認して承認するまで、それ以降の編集を一時停止します。再試行しても変更が二重に適用されることはありません。
Premiere の履歴に記録される操作は取り消し、それ以外はチェックポイントを作成	Premiere の履歴に記録される編集（エフェクトの追加や削除、カット、挿入）では undoSteps を報告し、undo で元に戻せます。各ステップは Premiere の取り消しスタック（実験的な QE）と照合されます。プロパティやマーカーの書き込みは記録されません。リスクのある編集の前に create_sequence_checkpoint でシーケンスを複製し、diff_sequence_snapshots で変更内容（追加、削除、移動、トリミングされたクリップとフレーム単位の差分）を正確に確認できます。
計画 → プレビュー → 適用	plan_* 操作は計算のみを行います。複合編集は、プレビュー時に発行された確認トークンを変更せずに使用した場合にのみ適用されます。
読み取り専用モード	PR_MCP_READONLY=true — 確認とエクスポートのみが可能で、プロジェクトは変更できません。
デフォルトでは生のスクリプト実行なし	pr_execute_script は PR_MCP_ENABLE_SCRIPT=true の場合にのみ利用できます。
テレメトリーなし	サーバーから外部へデータが送信されることはありません。

ツール

ツール	目的
pr_verify	コネクター、開いているプロジェクト、アクティブなシーケンスを確認します — 最初に呼び出すツールです
pr_get_sequence	トラックとクリップの node_id、タイム、速度を取得します
pr_catalog / pr_do / pr_batch	約440の操作（44カテゴリ）を検索し、1つまたは複数を実行します
pr_export_frame	シーケンスの1フレームをPNGで出力します — エージェントの目に相当します
pr_save_project	保存します
pr_install_connector	Premiere 内のコネクターを確認／インストールします
pr_skill	エージェントスキル：ルーターとそのリファレンスです
pr_execute_script	生の ExtendScript — 有効化した場合のみ

PR_MCP_FACADE=0 にすると、各操作が個別のツールとして一覧表示されます（定義だけで60万トークンを超え、ほとんどのコンテキストウィンドウの上限を超えます。9つのツールでは約1.5Kです）。

変数	デフォルト	意味
PR_MCP_READONLY	オフ	true → 確認とエクスポートのみ
PR_MCP_ENABLE_SCRIPT	オフ	true → pr_execute_script（任意の ExtendScript を実行）
PR_MCP_FACADE	オン	0 → 各操作を個別のツールとして表示
PREMIERE_MCP_CAPABILITIES	—	明示的なプロファイル。例：inspect,edit,export,filesystem。各スイッチより優先されます
PREMIERE_TEMP_DIR	OS の一時ディレクトリ	コネクターのファイル用メールボックス
PREMIERE_UXP_TOKEN	—	オプションの UXP ブリッジ（Premiere に UXP プラグインが必要）と、その *_uxp 操作を有効にします

スキル

skills/pr/SKILL.md は、エージェントが最初に読む短いルーターです（引数なしの pr_skill）。タスクに必要な参照資料を 1 つ示します（pr_skill {doc}）。

SKILL.md	ツール、作業の順序（状態 → チェックポイント → 操作 → 値で検証し、その後フレームで検証）、アドレス指定（ノード ID、ソース時間とシーケンス時間、選択範囲に基づく操作、ローカライズされた Premiere）、およびスクリプトでは Premiere でできないこととそれぞれの参照資料をまとめた表。
references/generative.md	Generative Extend、Generative Media Tool（最初／最後／参照フレームを使った動画、音声ガイド付き効果音、サウンドスケープ、音楽）、Firefly Boards からシーケンスへの変換、パートナーモデル、秒あたりのクレジット。
references/masking.md	Object Mask、新しいマスクが「何もしない」理由、クリップとフレームのキーフレーム、シャープネス／拡張、マスクデータの保存場所と欠落する原因。
references/speech-text.md	Speech to Text、間やフィラーのテキストベース編集、ペーパー編集、単語単位のキャプション、サーバーの単語タイムラインプランナー（フィラー、間、リテイク、ビープ音、キャプション）。
references/audio.md	Enhance Speech、ステム分離（ベータ）、UI とキーフレームによるダッキング、Remix、FFmpeg による解析。
references/timeline-automation.md	Auto Reframe、Scene Edit Detection、Morph Cut（およびディゾルブとして書き出される理由）、Color Match、Warp Stabilizer。
references/search-assistant.md	検索パネル（Media Intelligence、類似フレーム、サウンド検索）と、エージェントの隣にある AI Assistant ベータ版。
references/combos.md	ツールを組み合わせる 11 種類のレシピ：2 つのクリップ間に生成ショットを挿入、インタビューのノイズ除去、顔に追従するぼかし、ストーリーボードからシーケンスへの変換、ロケーション音楽の除去、SNS 用バージョン、無音部分とビートに合わせたカット。
references/gotchas.md	地域と言語による利用可否、クレジット、ベータ版とリリース版、カラーとサウンドへの引き継ぎ、書き出し、バグに見えるスクリプトの制限。

独自のスキルサポートを備えたクライアントでは、このフォルダーを直接読み込めます（例：skills/pr を ~/.claude/skills/ にコピーします）。

このサーバーを選ぶ理由

Premiere MCP サーバーはいくつかありますが、モデルに何が見えるか、何を把握しているか、何を外部に送信するかはそれぞれ異なります。2026-10-26 時点：

	Premiere-MCP-IMT	premiere-pro-mcp（上流）	AdobePremiereProMCP	Adobe_Premiere_Pro_MCP	flue
モデルにデフォルトで表示されるツール	9 個、約 440 の操作	カタログ全体（約 440 個のツール）	約 1,060 個のうち 74 個（standard プロファイル）	5 個、283 を超える操作	なし — エージェントが ExtendScript をパイプ処理
Premiere の AI ツールに関する知識	8 つの参照資料とレシピを含むスキル	2 つのスキル（編集、開発）	7 つのワークフロースキル	1 つのスキル	1 つのスキル（スクリプト作成）
英語以外の Premiere	すべての UI 言語（全 10 言語）でライブ検証済み	英語と es-ES で測定	記載なし	記載なし	記載なし
テレメトリー	なし	PostHog。キーが設定されていない限りオフ	確認できず	デフォルトで有効（オプトアウト可能）	記載なし
コネクターのインストール	エージェントが同意を得て実行。ライブセルフテスト付きインストーラー	CLI フラグ	ソースからビルド（Go、Rust、Python）	CLI フラグ	pip とセットアップ
クライアント	Claude Desktop（.mcpb）、Cursor、Antigravity、ChatGPT ゲートウェイ、任意の MCP クライアント	npm、.mcpb、Codex／Claude Code プラグイン	ソースからビルド	npm、プラグイン、.mcpb	CLI とスキル
ライセンス	Apache-2.0	MIT	MIT	MIT	MIT

上流コードに加えた変更は、スキルとパッケージ化だけではありません。matchName と、Premiere 自身の UI 辞書を通じて翻訳された英語名によるコンポーネントおよびプロパティの検索（ローカライズされた Premiere では、上流版の不透明度、モーション、キーフレーム、音量の各操作がすべて失敗していました）、指定したクリップをカットする split_clip（上流版はトラック 0 をカットしていました）、テレメトリーなし、stdio のみ、そしてコンパクトなツール構成です。

リリース

各バージョンの説明は リリースページにあります。変更内容はすべて CHANGELOG.mdに記載されています。

• v1.1.1 · 2026-10-28 — Premiere のホーム画面：プロジェクトが開かれていない場合、pr_verify がその旨を表示します。プロジェクトなしで試した編集によって、その後の編集が一時停止することもなくなりました。
• v1.1.0 · 2026-10-28 — premiere-pro-mcp 1.26.0 をベースに構築：すべての編集内容を Premiere から読み戻し、約60件の操作を追加し、UI 言語レイヤーを新しいコードに引き継ぎました。pr_install_connector でコネクターを再インストールしてください。
• v1.0.2 · 2026-10-28 — あらゆる場所で説明を強化：すべての Adobe UI 言語に対応し、大規模なスキルライブラリを備え、Adobe の生成機能向けに構築しました。
• v1.0.1 · 2026-10-28 — 製品名を Premiere-MCP-IMT に変更（旧名：PR-MCP-IMT）。MCP Registry のエントリーにも npm パッケージを掲載しました。パッケージは 1.0.0 から npm で公開されています。
• v1.0.0 · 2026-10-28 — あらゆる Premiere UI 言語に対応（英語名は Premiere 独自の辞書を通じて翻訳し、実機で検証済み）。不明なエフェクトに対して正確な結果を返し、カラー補正と LUT に対応。Apache-2.0。
• v0.1.0 · 2026-10-26 — 初の一般公開リリース：Premiere エージェントスキル、9つのツールを備えたインターフェース、pr_skill、エージェントによるコネクターのインストール、Claude Desktop 拡張機能、実機セルフテスト付きインストーラー、ChatGPT ゲートウェイ。

npm test はオフラインで実行でき、Premiere は不要です。

ライセンス

Apache License 2.0 — © Immersive Media Technologies.

• 無料で使用、変更、配布でき、商用利用も含まれます。
• 著作権表示が必要です。 本ソフトウェア、または本ソフトウェアを基にした著作物を再配布する場合は、必ず NOTICEの表示を含めてください： Premiere-MCP-IMT by Immersive Media Technologies — https://github.com/Immersive-Media-Technologies。
• 保証はありません。

サードパーティーに関する表示（上流の MIT コード）：THIRD-PARTY-NOTICES.md。Adobe、Premiere Pro、Firefly は Adobe Inc. の商標です。本プロジェクトは Adobe と提携しておらず、Adobe による推奨も受けていません。