ae-mcp

English | 简体中文

ワンライナーのセットアッププロンプト — これをClaude Codeまたは別のAIエージェントに貼り付けてください:

Install the ae-mcp ZXP and the native plug-in for my platform from the v0.10.3
release, open Window > Extensions
> ae-mcp in After Effects, then connect Claude Code with `claude mcp add
--transport http ae http://127.0.0.1:11488/mcp`; for Claude Desktop, configure
the extension's `host/stdio-shim.js` with the system Node executable and ask me
to start a new client session before testing `ae_status`.

ae-mcpは、After Effects CEPパネルをローカルMCPエンドポイント経由でAIクライアントに接続します。パネルはhttp://127.0.0.1:11488/mcpでサービスをホストし、ホストはExpressを使用するNodeプロセスです。After Effectsの状態には、ExtendScriptと凍結されたネイティブAEGPプレーンを通じてアクセスします。

インストールと初回実行

1. 署名済みZXPをAfter Effectsにインストールします。

2. ホスト用に選択したAfter Effectsプラグインの隣に、対応するネイティブプラグインをインストールします — Windowsでは.aex、macOSではAeMcpNative.pluginバンドルです。バージョンのペアは同じリリースのものを維持してください。ZXPはプラットフォームバイナリを含まず、両方のシステムにインストールできます。プラットフォームごとにビルドされるのはこのネイティブプラグインのみで、それを必要とするツールはae_nativeExecだけです。Installにはプラットフォームごとの正確なインストール先が記載されています。また、macOSバンドルは、After Effectsがロードする前にダウンロードの検疫が解除されている必要があります。

3. After Effectsを起動し、ウィンドウ > 拡張機能 > ae-mcpを開きます。外部クライアントがMCPを使用している間は、パネルを開いたままにしてください。

4. 次に示す2つのサポートされている外部接続形式のいずれかを設定します。

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

Related MCP server: After Effects MCP Server

クライアント接続

Claude CodeはURLトランスポートを使用します:

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

Claude Desktopは、システムのNodeインストールを通じて公開されているコネクタを使用できます。インストール済みの拡張機能ディレクトリにアクセスする必要はありません。このnpx -y ae-mcp-jkdg形式は、同じ依存関係のないhost/stdio-shim.jsをラップします:

{
  "mcpServers": {
    "ae": {
      "command": "npx",
      "args": ["-y", "ae-mcp-jkdg"]
    }
  }
}

あるいは、Claude Desktopは、インストール済み拡張機能に同梱されている依存関係のないstdioシムを実行できます。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"
      }
    }
  }
}

したがって、Claude DesktopにはシステムのNodeインストールが必要です。シムは1つのstdioリクエストキューを保持し、MCPレスポンスをパネルホストに転送します。

パネル機能

• ae_exec — 保守されているExtendScript操作用。

• ae_execRecover — ディスパッチされたae_execの失敗を、返されたidで再試行するため。

• ae_nativeExec — 凍結されたネイティブAEGPプリミティブ用。

• ae_previewFrame、ae_validateExpressions、構造化されたae_read、およびチェックポイント。

• バンドルされたスキルとローカルJSXツールライブラリ。

• 承認モード、アクティビティ履歴、診断、およびログエクスポート。

• ローカルCLIでのログインが利用可能な場合の組み込みClaude、Codex、OpenCodeチャネル。

公開MCPツールはCEPホストによって提供されます。書き込みの後には独立した読み戻しを行う必要があります。副作用を伴う可能性のある失敗は再試行前に整合させなければならず、Undoは個別に実行および検証する必要があります。

開発

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、共有モジュール、アイコン、および生成されたホストアセットのみをコピーします。ホストの正確なExpress 4.22.2依存関係を検証し、ZXPに一度だけ署名します:

.\scripts\package-zxp.ps1 -SkipSigning

署名済みZXPには、明示的に処理される.aexアーティファクト以外のネストされたネイティブバイナリを含めてはならず、20 MB未満を維持する必要があります。

保守されている運用の詳細については、Install、Reference、Releaseを参照してください。

ライセンス

ae-mcpはMITライセンスの下でリリースされています。LICENSEを参照してください。AdobeのCSInterface.jsは、そのアップストリームのライセンス表示を保持します。