ae-mcp

ae-mcp

英語 | 简体中文

Install and configure ae-mcp for the current client receiving and executing
this prompt. Do not default to Claude Code or configure another client.
Before changing anything, inspect the local ae-mcp extension and native plug-in
files and versions, plus this client's existing MCP registration and actual
connection, read-only. Existence alone does not prove readiness. Compare with
the latest official stable release assets available for my platform:
- Client registration already correct: keep it; install only missing or damaged files.
- Files complete and versions suitable: only add or repair client registration.
- Both ready and current: verify without reinstalling.
- Newer version available: upgrade existing components, preserving user settings
  and other MCP configuration; do not downgrade. If versions cannot be established
  or platform assets are unavailable, explain rather than blindly overwrite.
Use the release ZXP and platform-native plug-in for needed file installation or
upgrade, then open Window > Extensions > ae-mcp in After Effects.
Identify this client's configuration method and location, preserving all other
MCP entries. Use http://127.0.0.1:11488/mcp if it supports Streamable HTTP;
for stdio only, configure `npx -y ae-mcp-jkdg` using this client's format.
If automatic editing is unavailable, give precise manual steps for this client.
Ask which client only if the target truly cannot be identified; never silently
fall back to Claude Code. Keep the AE panel open, refresh/reconnect or start a
new session as this client requires, then call ae_status to verify. If user
action is required first, state that verification is still pending.

AI に After Effects プロジェクトを読み込ませ、アニメーションを作成し、結果を確認して、成功した操作を再利用可能なツールとして保存できます。

ae-mcp は、実行中の After Effects プロジェクトを Model Context Protocol (MCP) に接続するオープンソースの CEP 拡張機能です。パネル内で Claude、Codex、OpenCode とチャットするか、外部 MCP クライアントを接続してコンポジション、レイヤー、キーフレーム、エクスプレッションを操作できます。

Download v0.11.1 · インストール · ツールリファレンス · 変更履歴

できること

• 実際のプロジェクト状態を読み取る： ページネーション、並べ替え、フィルタリングを使って、プロジェクト、コンポジション、レイヤー、プロパティ、キーフレームを確認できます。
• アニメーションを作成・編集する： 汎用的な AE 操作には ExtendScript を実行し、正確な時間とオブジェクトのロケーターにはネイティブ AEGP ツールを使用します。
• コンポジションのピクセルを確認する： AE から PNG フレームを書き出し、グリッド上の複数の時点をサンプリングして、A/B のピクセル差分を比較できます。
• 失敗した操作から復旧する： 保存済みプロジェクトのチェックポイント、記録した失敗スクリプト、recoveryId を使って状態を確認、修正、または復元できます。
• 再利用可能なツールを保持する： 成功したスクリプトは再実行可能な候補となり、保存、ピン留め、アーカイブ、エクスポート、インポートができます。プロンプトスキルにも対応しています。
• 実行状況を確認する： パネルの承認、アクティビティタイムライン、会話履歴、診断情報のエクスポートを利用できます。

ワークフローは、読み取り → 実行 → プレビュー → 修正 → 再利用のために保存、です。AI は AE ホストを通じて未保存の変更を含む現在の状態を読み取り、プロジェクト構造とコンポジションのプレビューの両方で結果を確認します。

一連のワークフロー

テスト用プロジェクトで、次のようなタスクを試してください。

Create a new composition with the text Hello AE. Over one second, fade it in
and move it upward into the center. Read back the keyframes, then check the
animation with a multi-frame preview.

スクリーンショットは、タスクの入力、6 フレームのプレビュー、ツールライブラリに記録された成功スクリプトを示しています。これらはワークフローを説明する実際の v0.10.7 の画面です。v0.11.0 で追加された内容については、以下をご覧ください。

タスクを説明する	結果を確認する	再利用可能なツールとして保存する

v0.11.1 の新機能

• ネイティブ Codex の画像プレビュー、ズーム、会話履歴の問題を修正しました。
• 外部 MCP 向けのガイダンス、ツールライブラリのスキャン、Windows AE プロセスの検出と再試行を改善しました。
• Windows および macOS のネイティブプラグインは引き続き 0.11.0 です。既存ユーザーは ZXP を手動で更新するだけで済みます。

v0.11.0 の新機能

• 複数インスタンスと並列プレビュー： 外部クライアントは複数の AE インスタンスを検出、起動し、接続先として指定できます。異なるプロジェクトを同時に実行でき、各プロジェクトにはアクティブな書き込み担当が 1 つ存在します。一方、読み取り専用ワーカーは固定されたチェックポイントのスナップショットを調査、プレビューできます。
• セッションの引き継ぎ： パネルでのターンや外部からの AE 呼び出しが完了すると、次に利用可能なセッションがアイドル状態のプロジェクトを引き継げます。実行中の呼び出し、エンジンのドレイン処理、書き込みの成否が不確かな場合は、引き継ぎが引き続きブロックされます。
• AI の作業ディレクトリ： 新しいチャットでは、デフォルトで現在の AEP のフォルダーを使用します。プロジェクトが未保存の場合、またはそのディレクトリに書き込みできない場合は、ユーザーのホームフォルダーに切り替わります。Settings でフォルダーを選択するか、デフォルトに戻せます。既存のチャットでは、現在のディレクトリが保持されます。
• Undo と復旧の修正： Undo グループの不一致とチェックポイントの復旧コンテキストに関する問題を修正しました。レンダリングは Undo グループの外で、別途実行する必要があります。
• ネイティブ機能とワーカーの信頼性向上： コールドスタート時のネイティブ診断、接続タイムアウトからの復旧、Windows のバックグラウンドワーカーの起動と終了時のクリーンアップを改善しました。
• 公開ツールが 13 個から 16 個に増加： ae_instances、ae_workspace、ae_readJob を追加し、対応する [email protected] stdio コネクターも追加しました。

このリリースでは、Windows/macOS 共通の ZXP、Windows x64 および macOS arm64 向けのネイティブプラグイン、チェックサムを提供します。最終版の Mac パッケージは、AE 26.3x87 arm64 で、対象を限定した読み書き、Undo、レンダリング、復旧、インストールの検証を完了しました。Mac のワーカーシナリオは未検証です。検証範囲と既知の制限については、v0.11.0 リリースノートをご覧ください。

インストールと初回起動

1. v0.11.1 リリースから ae-mcp-panel-v0.11.1.zxp をダウンロードしてインストールします。
2. ae_nativeExec を使用する場合は、同じリリースからネイティブプラグインをダウンロードします。Windows x64 の場合は AeMcpNative-v0.11.0-windows-x64.aex、macOS arm64 の場合は AeMcpNative-v0.11.0-macos-arm64.plugin.zip を使用します。Mac の ZIP を展開し、AeMcpNative.plugin をインストールします。ネイティブプラグインは ZXP とは別に配布されています。インストール先と macOS でのダウンロードファイルの隔離属性の処理については、インストールをご覧ください。Mac パッケージの動作には macOS 14.0 以降が必要です。どちらのプラットフォームでも約 60 MB の同一 ZXP を使用します。この ZXP には Windows 用 OpenCode ランタイムが含まれています。macOS では PATH 上の OpenCode を使用します。
3. After Effects を起動し、Window > Extensions > ae-mcp を開きます。外部クライアントが MCP を使用している間は、パネルを開いたままにしてください。
4. パネルの Settings で Claude、Codex、または OpenCode を設定するか、以下の説明に従って外部クライアントを接続します。

パネル自体が MCP サービスです。リポジトリのサーバーを別途起動する必要はありません。デフォルトのエンドポイントはループバックであるため、外部クライアントは After Effects と同じマシン上で実行する必要があります。

クライアント接続

実行中のパネルが1つの場合、Streamable HTTP に対応するクライアントは、パネルに表示されている URL に接続できます。たとえば、デフォルトのアドレスを使用する Claude Code の場合：

claude mcp add --transport http ae http://127.0.0.1:11488/mcp

インスタンスの検出と起動、または Claude Desktop のような stdio クライアントには、 対応するコネクターを使用します（Node.js 18 以降が必要です）：

{
  "mcpServers": {
    "ae": {
      "command": "npx",
      "args": ["-y", "[email protected]"]
    }
  }
}

URL を明示しない場合、コネクターはインストール済み拡張機能の マルチインスタンスエントリーを検出します。拡張機能のインストールや更新は行いません。 ae_instances でインスタンスを検出するか明示的に起動し、ae_workspace でプロジェクトを バインドして、以降の AE 呼び出しで返された context_id を渡してください。 --url または AE_MCP_HTTP_URL を設定すると、転送先は1つのエンドポイントに固定されます。 パネルを閉じると意図的に切断され、AE が自動的に再び開くことはありません。

別の方法として、インストール済み拡張機能に同梱されている依存関係不要の stdio シムを実行できます。 この例では、転送先を1つのエンドポイントに固定します。command にシステムの Node を設定し、 args で拡張機能ディレクトリ内の host/stdio-shim.js を指定します：

{
  "mcpServers": {
    "ae": {
      "command": "node",
      "args": ["<installed-extension>/host/stdio-shim.js"],
      "env": {
        "AE_MCP_HTTP_URL": "http://127.0.0.1:11488/mcp"
      }
    }
  }
}

セットアップ後にクライアントを更新または再接続し、ae_status を呼び出して確認してください。

仕組み

MCP サービスは CEP パネルの Node ホスト内で直接実行され、デフォルトでは http://127.0.0.1:11488/mcp で動作します。追加のインスタンスはそれぞれ独自のエンドポイントを 登録します。ホストは承認、プロジェクトコンテキスト、Tool Library、 ログを管理します。

flowchart TB
    panel["In-panel AI chat"] --> host["CEP Node MCP host"]
    client["External MCP client"] -->|"HTTP / stdio connector"| host

    host --> jsx["ExtendScript"]
    host --> native["AEGP"]
    host --> worker["Read-only workers"]

    jsx --> project["AE project reads / writes"]
    native --> precision["Exact time and object locators"]
    worker -->|"Checkpoint snapshot"| preview["Reads and PNG previews"]

ExtendScript は一般的な操作を処理します。ネイティブ AEGP プレーンには、正確な有理数時間と 世代に紐づくオブジェクトロケーターのための23個の固定プリミティブが保持されています。 複数のインスタンスから同じプロジェクトに同時に書き込むことはできません。 ワーカーの結果は常に、指定されたチェックポイントのスナップショットを示します。 詳細はアーキテクチャを参照してください。

パネルの機能

CEP ホストは、16個の公開 MCP ツールを提供します：

成功した ae_exec と ae_execRecover のスクリプトは、重複を除いた再実行可能な Tool Library の候補として 記録されます。ae_toolSave は、再利用可能な JSX とプロンプトスキルのアーティファクトを昇格または作成します。 Tools ページでは、候補と保存済みアーティファクトを管理でき、インポートとエクスポートにも対応しています。 使用カウンターとファネルイベントで、何が再実行または保持されたかを確認できます。また、プレースホルダーガードは、 圧縮された会話から正確な候補へ誘導し、プレースホルダーの再試行が繰り返されるのを防ぎます。

パネルには、承認モード、アクティビティ履歴、診断、ログのエクスポート、および組み込みの Claude、Codex、 OpenCode チャネルも用意されています。ホストの永続状態のデフォルト保存先は ~/.ae-mcp です。 開発者とテストでは AE_MCP_STATE_DIR を使って保存先を変更できます。

公開 MCP ツールは CEP ホストによって提供されます。書き込み後は独立した読み戻しを行ってください。 副作用が発生した可能性のある失敗は、再試行する前に整合性を確認する必要があります。 Undo は個別に実行し、検証してください。タイムアウトが発生しても、同期 ExtendScript の処理を直ちに中断できるとは限りません。 PNG プレビューには Guide レイヤーが含まれない場合があります。複数フレームや差分のパラメーター、 復旧ルール、スナップショットジョブについてはリファレンスを参照してください。

開発

2 つの Node ワークスペースをインストールし、パネルをビルドします：

(cd plugin/host && npm ci)
(cd plugin/panel && npm ci && npm run build)

ローカルの CEP デプロイでは、ホストとパネルのビルド後に、プラットフォーム固有のスクリプトを使用します：

.\scripts\install-plugin-dev.ps1

./scripts/install-plugin-dev-macos.sh

Adobe After Effects C/C++ Plug-in SDK は開発者が用意する入力であり、このリポジトリの外部に置く必要があります。ネイティブプラグインをビルドする前に確認してください：

node scripts/package/ae-sdk-input.mjs verify-input --platform macos-arm64

凍結されたネイティブプレーンでは、リポジトリ外の新しいディレクトリにビルドします。インストーラーはトランザクション状態を native-plugin-dev-v1 に保持します。ビルド結果をインストールする場合は、返されたトランザクション ID を保存してください：

AE_SDK_ARCHIVE=/absolute/path/AfterEffectsSDK.zip
AE_SDK_ROOT=/absolute/path/AfterEffectsSDK
BUILD_DIR=/private/tmp/ae-mcp-native-dev
TRANSACTION_ID="paste-the-transaction-id-here"
node native/ae-plugin/build-macos.mjs \
  --sdk-archive "$AE_SDK_ARCHIVE" \
  --sdk-root "$AE_SDK_ROOT" \
  --output "$BUILD_DIR"
# The install state root is native-plugin-dev-v1.
node native/ae-plugin/install-dev-macos.mjs install --artifact-dir "$BUILD_DIR"
node native/ae-plugin/install-dev-macos.mjs rollback \
  --transaction "$TRANSACTION_ID"

ネイティブプレーンは凍結されています。生成済みの AEGP プロトコルファイルはチェックインされており、機能パッケージのコード生成パイプラインは通常の開発には含まれません。

テストとパッケージング

ローカルで対象を絞った Node コントラクトを実行します：

node --test scripts/package/test/verify-windows-zxp-stage.test.mjs
node --test scripts/package/test/zxp-payload-audit.test.mjs

Windows の ZXP ステージングコマンドは、パネル、ホスト、JSX、共有モジュール、アイコン、生成されたホストアセット、および node scripts/package/fetch-opencode-runtime.mjs でステージングされた固定バージョンの OpenCode ランタイムをコピーします。ホストの Express の依存関係が正確に 4.22.2 であることを検証し、ZXP に一度署名します：

.\scripts\package-zxp.ps1 -SkipSigning

署名済み ZXP にネイティブバイナリを含めることはできません。同梱される opencode.exe は、明示的に許可された実行ファイルです。パッケージングスクリプトは 80 MB を超えると失敗します。ランタイムを含むリリースは約 60 MB です。

運用および開発に関する最新の詳細は、インストール、リファレンス、ツールライブラリ、アーキテクチャ、ワークフロー、リリースをご覧ください。

スポンサー

ae-mcp の開発とメンテナンスを支援してくださる皆さまに感謝します！

スポンサーシップは任意であり、金額を問わずありがたく存じます。ご支援は、プロジェクトの開発とメンテナンスに役立ちます。

PayPal で支援する

WeChat Pay または Alipay で支援するにはスキャンしてください

対応するアプリでスキャンしてください。

WeChat Pay	Alipay

スポンサーへの謝辞

ライセンス

ae-mcp は MIT License のもとで公開されています。詳細は LICENSE をご覧ください。Adobe の CSInterface.js には、上流のライセンス表記がそのまま残されています。