mcpField
P
premiere-pro-mcp

premiere-pro-mcp

github.com/hetpatel-11クリエイティブ・メディア774866 回インストール4 日前に更新
リポジトリ

premiere-pro-mcp について

Adobe Premiere Pro MCPサーバーの利用者向けに、インストール、ブリッジ設定、編集操作を案内するスキルです。変更や書き出しの前にプロジェクト状態と操作の影響を確認する手順を重視します。

主な機能

  1. 01MCPツールの検索と呼び出し方法
  2. 02インストール、登録、ブリッジ設定
  3. 03プロジェクト、シーケンス、素材の確認
  4. 04インポート済み素材を使う編集フロー
  5. 05トラブルシューティングと安全な検証

活用シーン

  1. 01Premiere Pro MCPサーバーの導入と接続
  2. 02プロジェクトのシーケンスと素材の確認
  3. 03編集を計画し、シーケンスを作成して結果を検証

MCP 対応

`hetpatel-11/Adobe_Premiere_Pro_MCP`のMCPサーバー向けスキルです。`search_tools`でツールを探し、`invoke_tool`で呼び出す方法やPremiere ProのCEPブリッジ設定を説明します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hetpatel-11/adobe_premiere_pro_mcp --skill premiere-pro-mcp

インストール後、Claude Code で/premiere-pro-mcpを入力して読み込まれたか確認します。

詳細

Adobe Premiere Pro MCP

hetpatel-11/Adobe_Premiere_Pro_MCP の Adobe Premiere Pro MCP サーバーを使用する場合は、このスキルを使用してください。

基本ルール

  • Premiere の操作には MCP ツールを使用してください。必要な操作が MCP ツールで提供されていない場合を除き、ExtendScript を独自に作成しないでください。
  • デフォルトの MCP tools/list で表示されるのは、常時有効な小規模なツールセットです。search_tools（BM25 クエリまたは正規表現パターン）を呼び出してから、正確な名前を指定して invoke_tool を実行してください。PREMIERE_MCP_TOOLSET=full を設定すると、すべてのツールが表示されます。
  • まず読み取り専用の確認を行ってください。get_project_info、list_sequences、list_project_items、get_active_sequence、および関連するリソースの読み取りを使用します。
  • 実際にインポートされたメディアを使用してください。アセットを使った編集をユーザーが依頼した場合は、ファイルパスが存在することを確認し、import_media でインポートしてから、インポートしたプロジェクト項目 ID をシーケンスに配置してください。
  • MCP サーバーと CEP パネルで、一貫した一時ディレクトリを使用してください。ユーザーが別のパスを明示的に設定していない限り、/tmp/premiere-mcp-bridge を使用します。
  • 破壊的な操作や外部から見える操作を行う前に、確認してください。対象には、クリップやメディアの削除、書き出しの上書き、プロジェクトを閉じること、重要なプロジェクトファイルへの上書き保存、ファイルの外部送信が含まれます。
  • 生成用またはデモ用の編集では、ユーザーのアクティブなシーケンスを変更するのではなく、わかりやすい名前を付けた新しいシーケンスを作成してください。
  • ツールが success: false を返した場合は、エラーを正確に伝え、見当違いの再試行をする前に診断を実行してください。

インストール手順

ユーザーから MCP のインストールまたはセットアップを依頼された場合：

  1. OS を確認してください。自動インストーラーは macOS を主な対象としています。
  2. リポジトリをクローンするか、開いてください：
git clone https://github.com/hetpatel-11/Adobe_Premiere_Pro_MCP.git
cd Adobe_Premiere_Pro_MCP
  1. macOS では、次を実行してください：
npm run setup:mac
  1. macOS 以外の場合、またはクライアントを手動でセットアップする場合は、次を実行してください：
npm install
npm run build
  1. 次を使用して、ユーザーのクライアントに MCP サーバーを登録してください：
command: node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js
env: PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge

Codex の場合は、次を優先してください：

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

Premiere Bridge の起動

インストール後：

  1. 起動時にのみ設定を読み込む MCP クライアントの場合は、再起動してください。
  2. Premiere Pro を再起動してください。
  3. Window > Extensions > MCP Bridge (CEP) を開いてください。
  4. Temp Directory を /tmp/premiere-mcp-bridge に設定してください。
  5. Save Configuration をクリックしてください。
  6. Start Bridge をクリックしてください。
  7. 編集ツールを実行する前に、ブリッジパネルに Premiere の準備完了が表示されていることを確認してください。

Premiere が起動していない場合でも、MCP のインストール、ビルド、登録はできますが、ツールのライブ検証には Premiere と CEP ブリッジパネルが必要であることをユーザーに伝えてください。

検証

ローカルでチェックを実行してください：

npm run setup:doctor

Premiere が起動し、ブリッジが開始されている場合は、安全な読み取り専用の呼び出しで検証してください：

  • get_project_info
  • list_sequences
  • list_project_items

より詳細な検証を使い捨てのプロジェクトで行う場合は、create_sequence_from_clips、または実在する .sqpreset パスを指定した create_sequence でテスト用シーケンスを作成し、list_sequences を呼び出してシーケンスが存在することを確認してください。新しいバージョンの Premiere ではネイティブダイアログが開き、CEP がブロックされる可能性があるため、プリセットを指定せずに空のシーケンスを作成しないでください。

編集の進め方

  • まずプロジェクトの内容を把握してください。プロジェクト情報、アクティブなシーケンス、既存のメディア、トラック、マーカー、選択中のシーケンスを確認します。
  • 変更を加える前に、具体的な Premiere の操作手順に基づいて計画を立ててください。
  • ラフカットでは、まずメディアをインポートし、続いて create_sequence_from_clips を使用してください。これにより、Premiere がネイティブダイアログを開かずに設定を決定できます。create_sequence は実在する .sqpreset を指定する場合にのみ使用してください。既存のシーケンスで意図する設定が定義されている場合は、clearContents=true を指定して duplicate_sequence を使用してください。
  • 製品やブランドの映像では、ユーザーの依頼内容がそれらのワークフローに合う場合、assemble_product_spot または build_brand_spot_from_mogrt_and_assets を優先してください。
  • 白黒のルックには、彩度のみを汎用的に変更するのではなく、Black & White を指定した apply_effect を使用してください。
  • タイムラインのカットには、シーケンス対応のツールを優先し、利用できる場合は sequenceId を含めてください。
  • 書き出しは、出力パス、形式／プリセット、上書き時の動作を確認してから行ってください。

トラブルシューティング

コマンドがタイムアウトしたり、ブリッジエラーが報告されたりする場合：

  1. Premiere が開いていることを確認します。
  2. Window > Extensions > MCP Bridge (CEP) が開いており、ブリッジが起動していることを確認します。
  3. 両方の側で同じ一時ディレクトリが使われていることを確認します。
  4. 次を実行します：
npm run setup:doctor
  1. CEP パネルで Run Diagnostics をクリックするようユーザーに依頼します。
  2. /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json が存在する場合は読み込みます。
  3. 古いことが明らかで、ブリッジが停止中またはアイドル状態の場合に限り、古いコマンドファイルやレスポンスファイルを削除します。

よくある修正方法：

  • 一時ディレクトリでの ENOENT：/tmp/premiere-mcp-bridge を作成し、設定を再度保存して、ブリッジを再起動します。
  • Premiere ではツールが成功しているのに失敗と報告される：再試行する前に、list_sequences または該当するリストツールを実行して状態を確認します。
  • 一時ディレクトリ設定が空または不正な形式：フィールドにはパスのみを設定します。JSON や環境変数の代入形式は指定しません。

コメント

Markdown 対応