ae-mcp

Adobe After Effects用の高度なMCPサーバー。アシスタントにエディタのツールキットを提供します。プロジェクトの読み取り、レイヤーの作成とリグ、実際の速度カーブを使ったキーフレーム設定、テキストのアニメーション、ベクターシェイプの構築、エフェクトとエクスプレッションの適用、ネイティブメニューの操作、そして結果の確認を、会話に直接返されるスナップショットを通じて行えます。

アーキテクチャ

Assistant (MCP)
      │  stdio
┌─────▼──────────────────────────────┐
│  ae-mcp server (Node/TypeScript)   │   easing, SVG, presets, schemas
└─────┬──────────────────────────────┘
      │  1. HTTP 127.0.0.1:9782  (CEP transport, primary)
      │  2. watched JSON files    (ScriptUI transport, fallback)
┌─────▼──────────────────────────────┐
│  bridge inside After Effects       │   CEP panel or ScriptUI panel
└─────┬──────────────────────────────┘
      │  $.evalFile + AEMCP.runFile()
┌─────▼──────────────────────────────┐
│  ExtendScript kernel (AEMCP)       │   ~4,000 lines, 60+ commands
└────────────────────────────────────┘

3つの原則:

• 重い処理はNode側に置く。 SVG変換、イージング計算、アニメーションプリセットはすべてサーバー側で準備し、ExtendScriptカーネルは実行するだけ。

• やり取りはファイル経由で行う。 リクエストとレスポンスはJSONとしてディスク上を移動し、evalScriptのエスケープやサイズ制限を回避。HTTPは実行をトリガーするだけ。

• すべてがアトミックである。 各リクエスト（50操作のバッチでも）は単一のUndoグループ内で実行され、Ctrl+Z1回で全部元に戻せます。

ブリッジ認証トークン

CEPパネルのHTTPサーバーは127.0.0.1で待ち受け、After Effects内のコマンド（任意のExtendScriptを実行するae_evalを含む）をトリガーします。AE実行中にブラウザで開いているWebページが、単純なfetch()でブリッジを操作するのを防ぐため、パネルは初回起動時にランダムなトークンを生成し、Documents/ae-mcp/bridge/token.txtに保存して、bridge.json（tokenフィールド）にも再公開します。すべてのPOST /runまたはPOST /reloadにはX-AE-MCP-Tokenヘッダーが必要で、ない場合はサーバーは401を返します。MCPクライアント（src/bridge/client.ts）はbridge.jsonからトークンを読み取り、自動的に送信するため、手動設定は不要です。トークンはtoken.txtが存在する限り保持され、削除すると次回パネル起動時に再生成されます。

フォールバックのファイルトランスポート（req//res/）にはトークンがありません。ユーザーのDocumentsフォルダのOS権限に依存しており、別アカウントからのアクセスはすでにブロックされています。

Related MCP server: After Effects MCP Server

インストール

npm install
npm run build
npm run install-bridge      # installs the CEP extension + ScriptUI panel + kernel

次に、After Effectsで:

• CEPトランスポート（推奨） — After Effectsを再起動します。ブリッジは自動的に起動し、ウィンドウは表示されません。Window > Extensions > AE MCP Bridgeでステータス、ポート、ログが表示されます。

• ScriptUIトランスポート（再起動不要） — File > Scripts > Run Script File…を選択し、Documents/ae-mcp/AE MCP Bridge.jsxを選びます。パネルはすぐにポーリングを開始します。

MCPクライアントにサーバーを登録します:

claude mcp add ae-mcp -- node "/path/to/ae-mcp/build/index.js"

npm run install-bridgeは、検出されたAfter EffectsインストールのScripts/ScriptUI Panelsにもパネルをコピーし、ドッキング可能にします。そのコピーはProgram Files配下に置かれるため、管理者権限が必要です。失敗しても他には影響しません。

ツール

他との違い

実際の速度カーブ。 ease: "expo.out"は単なるイージーイーズではなく、ベジェカーブを各次元の影響と速度に変換し、セグメントの平均速度から計算します。グラフエディタを手動で調整するのとまったく同じです。

相対値。 slideInはmode: "offset"を使用します。アニメーションはレイヤーの既存の位置を上書きせず、その上に構築されます。スケールでもmode: "multiply"で同じ考え方です。

SVGが本物のシェイプに。 ae_shape action=svgはpath、rect、circle、ellipse、line、polyline、polygon、グループとそのトランスフォームを、塗り、ストローク、破線、ベジェ近似の円弧を持つネイティブで編集可能なシェイプレイヤーに変換します。

視覚的なフィードバックループ。 ae_render action=snapshotはコンポをレンダリングし、画像を直接返します。アシスタントは出力をリファレンスと比較して修正できるため、手探りで作業する必要がありません。

参照付きアトミックバッチ。 シーン全体を1回のラウンドトリップで構築でき、各ステップは{{0.index}}や{{prev.id}}で前のステップの結果を再利用できます。

開発

npm run build          # kernel + TypeScript
npm run build:kernel   # kernel only (also checks its syntax)
node scripts/ae.mjs status                       # bridge status
node scripts/ae.mjs layer.list '{"comp":"My Comp"}'
node scripts/selftest.mjs                        # full validation against AE
node scripts/selftest.mjs --keep --only=shape    # subset, keeps the comp

カーネルはhost/kernel/のモジュールに分割され、scripts/build-kernel.mjsによってhost/aemcp-kernel.jsxに連結されます。ES3互換である必要があります: let/const、Array.prototype.map、ネイティブJSON（プレリュードにポリフィルが用意されています）は使用できません。

トラブルシューティング