After Effects MCP · 上級者向け
ラーニングループ — ワークフローとともに成長するMCP
AE MCPには220以上のツールが搭載されています。使っていくうちに、同じ形で繰り返し実行したJSXスニペットがジャーナルに記録され、あなた（またはClaude）はそのパターンを、適切なスキーマとパラメーターを備えた新しいMCPツールに昇格できます。再ビルドもAfter Effectsの再起動も不要です。他のAdobe向けMCPにはない、Synthetic独自の仕組みです。
なぜ重要なのか
- · トークンが減る。 Claudeは30行のJSXを生成する代わりに、2つの引数でツールを呼び出します。
- · エラーが減る。 毎回ゼロから生成するJSXではなく、検証済みのスキーマを使います。
- · 実際の使い方から学ぶ。 昇格されるのは、あなたが実際に繰り返しているパターンです。
- · 100%元に戻せる。 PC上のJSONファイルにすぎません。1行削除すれば、そのツールは消えます。
仕組み
run_jsx_json ─▶ journal.jsonl ─▶ analyze.mjs ─▶ (tú eliges) ─▶ promote.mjs ─▶ wrappers.json
JSX libre cada llamada detecta shapes template tool nuevo
repetidos + JSON vivo al reconectar
params candidatos el cliente MCP4つのステップで、すべてローカルで完結します：
1. 自動ジャーナリング
MCPクライアントがツールを呼び出すたびに、サーバーは~/.synthetic-ae-mcp/journal.jsonlに1行を追記します。run_jsx / run_jsx_jsonの呼び出しではコード全体を保存し（これが候補になります）、それ以外のツールではツール名と引数のキーのみを保存します（ペイロードは保存しません）。ジャーナルへの記録はベストエフォートで、書き込みに失敗してもツールの呼び出しは通常どおり完了します。
2. 分析：繰り返しのパターンを見つける
# desde el repo del MCP (clonado o vía npx) node scripts/analyze.mjs # reporte human-readable node scripts/analyze.mjs --json # output JSON para scripting node scripts/analyze.mjs --min 3 # subir el umbral (default 2)
アナライザーはJSXを正規化し（コメントを除去し、文字列と数値をトークンに置き換えます）、シグネチャごとにグループ化します。そして2回以上繰り返し出現する形ごとに、実行された回数、値が変わるリテラルの位置（これがパラメーターになります）、コードのサンプルを報告します。
3. 昇格：新しいツールを作成する
名前、テンプレート、パラメーターの型を指定したJSON specを定義します。例：名前に特定の文字列を含むすべてのコンポジションにframeRate=Xを設定するツール：
{
"name": "ae_set_framerate_batch",
"description": "名前に<pattern>を含むすべてのコンポジションのframeRateを設定します。",
"code": "var n = 0; for (var i = 1; i <= app.project.numItems; i++) { var it = app.project.item(i); if (it instanceof CompItem && it.name.indexOf({{pattern}}) >= 0) { it.frameRate = {{fps}}; n++; } } __write({ ok: true, updated: n });",
"params": [
{ "name": "fps", "type": "number", "required": true, "description": "目標のフレームレート" },
{ "name": "pattern", "type": "string", "required": false, "default": "", "description": "コンポジション名で照合する文字列（空欄 = すべて）" }
]
}node scripts/promote.mjs spec.json # OK promoted 'ae_set_framerate_batch' (2 params) -> ~/.synthetic-ae-mcp/wrappers.json # Reconnect the MCP (or restart the client) to see the new tool.
4. 反映：ツールがクライアントに表示される
サーバーは、tools/listのたびにwrappers.jsonを読み込み直します。Claude Desktop / Cursor / Codexを再接続すれば、ae_set_framerate_batch(fps, pattern)が完全なMCPスキーマ付きで、ネイティブのツールと同じように使えるようになります。Claudeがこれを呼び出すと、サーバーはテンプレートに値を埋め込み、run_jsx_jsonを通じて実行します。アーキテクチャの変更も再ビルドも不要です。
パラメーターの型
| 型 | JSXでの展開結果 |
|---|---|
| string | JSONエスケープされた文字列："hello" → "hello" |
| number | 数値リテラル：24 → 24 |
| boolean | true / false |
| array | JSONリテラル：[1,2,3] → [1,2,3] |
| object | JSONリテラル：{"a":1} → {"a":1} |
| raw | そのまま挿入（上級者向け） |
プライバシーとセキュリティ
- · すべてローカルで完結します：
~/.synthetic-ae-mcp/はお使いのPC上のフォルダーです。どこにもアップロードされません。 - · ジャーナルには、run_jsx[_json]の呼び出しがコード全体とともに記録されます。その他のツールは、名前と引数のキーのみを記録します（値は記録しません）。
- · フォルダーを変更するには：MCP設定で
AE_MCP_DATA_DIRを設定します。 - · リセットするには：
~/.synthetic-ae-mcp/を削除します。