after-effects-mcp MCP — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

14以上のツール: コンポジション、レイヤー、カメラ、ヌル、キーフレーム、エクスプレッション、マスク
ExtendScriptブリッジパネルがコマンドをポーリング — AEプロセス内で実行
Claude Codeとは.mcp.json経由で連携、他のクライアントは手動設定で対応
ブレンドモード、3Dレイヤー、トラックマット、マスクフェザー/エクスパンションに対応
batchSetLayerPropertiesによるプロパティの一括更新

ライブデモ

実際の動作

after-effects.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "after-effects",
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "after-effects": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "after-effects-mcp"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add after-effects -- npx -y after-effects-mcp

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： after-effects-mcp

CSVからテンプレートベースのローワーサードを生成する

👤 1エピソードあたり10件以上のローワーサードを作成するモーショングラフィックスアーティスト ⏱ ~20 min intermediate

使うタイミング： 名前・肩書きのCSVがあり、1つずつコンポジションに手入力したくない場合に使用します。

前提条件

ブリッジパネルがインストールされたAfter Effects 2022以降 — npm run install-bridgeを実行し、mcp-bridge-auto.jsxを開いて「Auto-run commands」にチェックを入れてください
.mcp.json経由でMCPを追加済み — build/index.jsを指定してクライアントを再起動してください

フロー

ベースコンポジションを作成

Create a composition 'LT_01' 1920x1080 29.97 5s black background.✓ コピーしました

→ AE上にコンポジションが表示される
名前と肩書きのテキストレイヤーを追加

Add text layer 'Dr. Jane Doe' bottom-left at (120, 900) 72pt. Add text layer 'Lead Scientist' below at (120, 960) 36pt.✓ コピーしました

→ レイヤーが表示される
キーフレームでイン/アウトアニメーションを追加

Set position keyframes: both text layers slide in from x=-400 between frames 0-15 and slide out from frames 120-135.✓ コピーしました

→ アニメーション付きローワーサード

結果： CSV各行に対して複製・編集可能なローワーサードテンプレートが完成します。

注意点

ブリッジパネルの「Auto-run」にチェックが入っていない — コマンドが永遠にキューに溜まる — AEを再起動するたびにパネルを開いてチェックボックスを確認してください
一度に大量のコマンドを送るとAEのUIがフリーズする — 100個の個別呼び出しではなく、batchSetLayerPropertiesでまとめて処理してください

組み合わせ： filesystem

エクスプレッション駆動のデータビジュアライゼーションを作成する

👤 インフォグラフィックスを制作するモーションデザイナー ⏱ ~20 min advanced

使うタイミング： データ配列に基づいてシェイプをアニメーションさせたいが、個別にキーフレームを打ちたくない場合に使用します。

フロー

ベースシェイプを作成

Create a shape layer 'bar_01' — rectangle, center-anchored, 80x0 at (200,900).✓ コピーしました

→ 高さゼロのシェイプが表示される
エクスプレッションを適用

On bar_01 Scale.y, set expression that grows from 0 to [value] over 30 frames, eased.✓ コピーしました

→ エクスプレッションが適用され、正しく再生される

結果： 1つのシェイプ＋エクスプレッションで、ループ処理によりデータポイントごとに複製可能な状態が完成します。

ベースレイヤーを複製してコピーごとにプロパティを調整する

👤 N個のアイテムにデザインを展開する必要があるすべてのユーザー ⏱ ~10 min beginner

使うタイミング： スタイル設定済みのロゴが1つあり、円状に配置した12個のバリエーションが必要な場合に使用します。

フロー

N回複製する

Duplicate layer 'logo_base' 12 times, name them logo_00 through logo_11.✓ コピーしました

→ 12個のレイヤーが存在する
各レイヤーを配置する

For each logo_NN, set position to a point on a 400px radius circle around (960,540), angle = NN * 30 degrees.✓ コピーしました

→ ロゴがリング状に配置される

結果： 数秒できれいに整列したグループが完成します。

組み合わせ

他のMCPと組み合わせて10倍の力を

after-effects + davinci-resolve

AEでモーショングラフィックスを作成し、Resolveで編集を仕上げる

After Effectsで6秒のタイトルカードを作成し、~/renders/title.movにレンダリングした後、アクティブなResolveタイムラインの先頭にインポートしてください。✓ コピーしました

after-effects + filesystem

ディスク上のデータファイルからAEコンポジションを生成する

./data/speakers.csvを読み込み、各行のスピーカー名と肩書きでAEにローワーサードコンポジションを作成してください。✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
create-composition	name, width, height, duration, frameRate	新規コンポジション作成	free (local AE)
run-script	script: ExtendScript	名前付きツールでカバーされていない操作のエスケープハッチ	free
get-results	command_id: str	ブリッジからの非同期結果を取得	free
setLayerKeyframe	layer, property, time, value	キーフレームを追加	free
setLayerExpression	layer, property, expression: str	プロパティにエクスプレッションをバインド	free
setLayerProperties	layer, properties: object	トランスフォーム、不透明度、ブレンドモードを更新	free
batchSetLayerProperties	updates: [{layer, properties}]	N回のラウンドトリップを回避	free
getLayerInfo	layer	変更前にレイヤー情報を確認	free
createCamera	name, options?	3Dワークフロー	free
createNullObject	name	リギング用の親ターゲット	free
duplicateLayer	layer	複製	free
deleteLayer	layer	クリーンアップ	free
setLayerMask	layer, maskShape, feather?, expansion?	マスクの追加・変更	free

コストと制限

運用コスト

APIクォータ: なし — ローカルAE自動化
呼び出しあたりのトークン: 小さなコマンド文字列を送信し、小さな応答を受信
金額: Adobe After Effectsのライセンスが必要です。MCP自体は無料です
ヒント: 大規模なシーンではbatchSetLayerPropertiesを使用してラウンドトリップを削減してください。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： なし

データ送信先： なし — ローカルブリッジのみ

絶対に付与しない： Run arbitrary ExtendScript from untrusted prompts — `run-script` can execute anything AE can

ブリッジパネルはコマンドを自動実行します — MCPセッション外ではAEを閉じるかチェックボックスをオフにしてください。
run-scriptはevalと同等です。生成されるプロンプトを必ずレビューしてください。

トラブルシューティング

よくあるエラーと対処法

Commands queue but never execute（コマンドがキューに溜まり実行されない）

ブリッジパネルの「Auto-run commands」にチェックが入っていません。チェックを入れてください。

確認： Look at mcp-bridge-auto.jsx panel

Module import error on MCP start（MCP起動時のモジュールインポートエラー）

Node 14以降が必要です。MCPリポジトリでnpm installを実行して依存関係をインストールしてください。

確認： node --version

AE hangs during batch operations（バッチ操作中にAEがハングする）

個別呼び出しが多すぎます。batchSetLayerPropertiesに切り替えてください。

Expressions error 'value is undefined'（エクスプレッションエラー「value is undefined」）

エクスプレッションが存在しないレイヤーまたはプロパティを参照しています。setLayerExpressionの引数のスペルを再確認してください。

確認： Open AE's expression error overlay

代替案

after-effects-mcp 他との比較

代替案	代わりに使う場面	トレードオフ
DaVinci Resolve MCP	モーショングラフィックスではなく編集やカラーグレーディングを行う場合	パイプラインの異なる工程
Manual ExtendScript via .jsx files	AIを使わず完全に手動で制御したい場合	チャットインターフェースなし

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る