mcp-aftereffects

mcp-aftereffects

英語 | 日本語

AI で Adobe After Effects を操作できる MCP サーバーです。

Claude Code や Claude Desktop などの MCP 対応クライアントを起動中の After Effects に接続すると、AI がプロジェクトの確認や編集からレンダリングまで行えます。

After Effects の操作方法を細かく指示する必要はありません。実現したいことを自然な言葉で説明するだけで、AI がプロジェクトの状態を確認し、必要な操作を実行します。

Windows / macOS · After Effects 2024–2026 · Node.js 24+

注意

このツールは、AI を通じて After Effects プロジェクトを直接操作します。

AI はプロジェクトの内容を読み取り、コンポジション、レイヤー、エフェクト、キーフレームなどを変更できます。

また、AI がプロジェクトから読み取った情報が、使用している AI サービスに送信される場合があります。これには、コンポジション名、レイヤー名、エクスプレッション、キーフレーム、フッテージファイルのパスなどが含まれる可能性があります。

NDA 対象のプロジェクトや未公開作品に使用する場合は、事前に、利用する AI サービスのデータ保持ポリシーと MCP クライアントのログを確認してください。

初めて使用する際は、重要なプロジェクトではなく、バックアップまたはテスト用の .aep ファイルで試すことをおすすめします。

できること

mcp-aftereffects を使うと、AI に After Effects の作業を依頼できます。

• プロジェクトの内容を確認
• コンポジションとレイヤーを調査
• レイヤーとプロパティを編集
• キーフレームを追加または変更
• エフェクトとマスクを編集
• テキストとシェイプを編集
• エクスプレッションを設定
• プロジェクトを保存
• プロジェクトのバックアップを作成、復元
• フレームをレンダリングして変更をプレビュー

たとえば、次のように指示できます。

「この Illustrator ファイルを読み込んで、見栄えのよいテキストアニメーションを作成してください。」

「この PDF に記載されている修正を適用してください。」

「この AEP に問題がないか指摘してください。」

複雑な作業でも、AI はプロジェクトの状態を確認しながら、必要な操作を組み合わせて実行できます。

必要条件

• Windows または macOS
• Adobe After Effects 2024 / 2025 / 2026
• Node.js 24 以降
• MCP 対応クライアント（Claude Code、Claude Desktop など）

通常のセットアップでは、After Effects 内にプラグインやパネルをインストールする必要はありません。After Effects を一度に 1 つだけ起動する場合が対象です。複数のインスタンスを同時に操作する場合（AfterFX.exe -m）は、小さな起動スクリプトが必要です。詳しくは複数の After Effects インスタンスをご覧ください。

After Effects の設定

After Effects の環境設定で、次の項目をオンにしてください。

環境設定 → スクリプトとエクスプレッション → 「スクリプトによるファイルへの書き込みとネットワークへのアクセスを許可」

この設定がオフの場合、AI は操作を正しく実行できません。

macOS の場合

初回使用時に、macOS からクライアントによる After Effects の操作許可を求められる場合があります。

許可されていない場合は、次の場所で設定してください。

システム設定 → プライバシーとセキュリティ → オートメーション

MCP クライアントまたはターミナルによる After Effects の操作を許可してください。

クイックスタート

After Effects を一度に 1 つだけ起動する場合、After Effects 側でのインストールは不要です。

まず、After Effects を起動し、操作するプロジェクトを開きます。

次に、MCP クライアントに mcp-aftereffects を登録します。

Claude Code

claude mcp add aftereffects -- npx -y @kumoproductions/mcp-aftereffects

Claude Desktop

MCP 設定ファイルに以下を追加します。

{
  "mcpServers": {
    "aftereffects": {
      "command": "npx",
      "args": ["-y", "@kumoproductions/mcp-aftereffects"]
    }
  }
}

ほかの MCP クライアントを使用している場合は、それぞれの登録方法に従って MCP サーバーを登録してください。

読み取り専用モード

プロジェクトの内容を変更せずに調査または監査したい場合は、読み取り専用モードを使用できます。

MCP クライアントの設定に以下を追加します。

{
  "mcpServers": {
    "aftereffects": {
      "command": "npx",
      "args": ["-y", "@kumoproductions/mcp-aftereffects"],
      "env": {
        "AE_MCP_READONLY": "1"
      }
    }
  }
}

引き続きプロジェクトを調査し、プレビュー用にフレームをレンダリングできます。

詳細設定

通常、設定は必要ありません。

After Effects が標準以外の場所にインストールされている場合など、環境によっては追加の設定が必要になることがあります。

After Effects の場所を指定する

After Effects が標準のインストールパスにない場合は、AE_MCP_EXE を使用して実行ファイルの場所を指定できます。

デフォルトでは、2026 → 2025 → 2024 の順に After Effects を自動検索します。

操作範囲を制限する

AE_MCP_ALLOW_CATEGORIES を使用すると、AI に許可する操作の種類を制限できます。

たとえば、用途に応じてキーフレーム関連の操作だけに権限を限定できます。

複数の After Effects インスタンス

After Effects は複数のコピーを同時に実行できます（AfterFX.exe -m）。各コピーは独自のプロジェクトを使用します。標準の状態では、サーバーが接続するのは通常起動した最初のコピーだけです。-m で起動したインスタンスは、サーバーが起動するスクリプトを受け取りません。これらを操作するには、常駐エージェントを一度インストールします。

npx @kumoproductions/mcp-aftereffects install-agent

これにより、After Effects のユーザーレベルの Scripts/Startup フォルダーに小さな起動スクリプトが配置されます（管理者権限は不要です。After Effects を更新した後は、再度実行してください）。次回の起動から、-m で起動したものを含むすべてのインスタンスが、それぞれ専用のメールボックスを使用します。サーバーは接続先のインスタンスを選択します。

• サーバーの env にある AE_MCP_INSTANCE は、セッション全体のデフォルトインスタンスを指定します。インスタンスの起動時に指定した ID、または開いているプロジェクトファイル（"shotA"、"shotA.aep"、あるいは同名のプロジェクトが複数ある場合はフルパス）で指定できます。
• すべてのツールには、単一の呼び出しで別のインスタンスを指定するための任意の instance 引数があります。
• ae_context と ae_do instance.list で、稼働中のインスタンスを確認できます。

起動時にインスタンス名を指定するには、起動に使用する環境で AE_MCP_INSTANCE を設定します。

set AE_MCP_INSTANCE=shotA
"C:\Program Files\Adobe\Adobe After Effects 2026\Support Files\AfterFX.exe" -m

名前を指定していないインスタンスにはランダムな ID（ae-…）が割り当てられ、プロジェクトファイルで指定することもできます。稼働中のエージェントが 1 つだけの場合、設定は不要です。複数が稼働していて名前が指定されていない場合は、推測して選ぶのではなく、呼び出しが NO_INSTANCE で失敗します。

エージェントは After Effects の実行中、サーバーの有無にかかわらず、メールボックスのポーリングを続けます。そのため、ユーザーごとの一時フォルダーにあるメールボックスディレクトリが、セッション全体を通じて信頼境界になります。メールボックスの場所は、エージェントのインストール時に起動スクリプトに固定されます。AE_MCP_RUNTIME_DIR を変更した場合は、install-agent を再実行してください（agent-status で古くなっているかどうかを確認できます）。

ワーカーインスタンスを使った並列作業

AI は自分でインスタンスを起動できます。instance.start は新しい After Effects を起動し、登録されるまで待機してから、プロジェクトのコピーを開けます。これは、メインインスタンスで開いているプロジェクトを安全に扱う方法です。

1. instance.start { name: "w1", copyFrom: "<main .aep>" } — 独自のコピーを持つワーカー
2. そのワーカーで作業します。instance: "w1" を指定して任意のツールを使用します
3. instance: "w1" を指定して ae_save_project を実行します
4. メインインスタンスで project.merge { path: "<the copy>" } を実行します。コピーはフォルダーとして取り込まれ、プロジェクト内の既存の内容には一切変更が加えられません
5. instance.stop { name: "w1" }

複数のワーカーを同時に実行できます。それぞれが独立した After Effects であるため、インスタンスごとに数ギガバイトのメモリを見込んでください。

任意の ExtendScript の実行

mcp-aftereffects には、標準の操作では処理できないプロセスのために、任意の ExtendScript を実行する高度な機能が含まれています。

この機能はデフォルトで無効になっています。

注意

任意の ExtendScript を有効にすると、After Effects の外部で操作が実行される可能性があります。

ファイルやプロセスの操作など、コンピューター全体に影響を及ぼす操作が許可される場合があります。

この機能はデフォルトで無効になっています。必要な場合にのみ有効にしてください。

有効にするには、MCP サーバーの環境変数に次の値を設定します。

"env": {
  "AE_MCP_ENABLE_EVAL": "1"
}

通常の操作では実現できない高度な処理や、カスタム ExtendScript が必要な場合にのみ、この機能を使用してください。

公式リリース

メモ

公式リリースは npm と GitHub Releases のみで配布されています。

@kumoproductions/mcp-aftereffects を名乗るパッケージや、このサーバーを名乗るファイルを他の場所から入手する場合はご注意ください。

トラブルシューティング

操作のタイムアウト

次の点をご確認ください。

• After Effects は起動していますか？
• プロジェクトは開いていますか？
• 「スクリプトによるファイルへの書き込みとネットワークへのアクセスを許可」はオンになっていますか？
• macOS では、オートメーションのアクセス許可が有効になっていますか？

NO_INSTANCE

呼び出し先となる After Effects がありません。起動中の After Effects がすべて -m 付きで起動されていてエージェントがインストールされていない（複数の After Effects インスタンスを参照）、AE_MCP_INSTANCE / instance で指定されたインスタンスが起動していないかダイアログで停止している、または複数のエージェントが起動中で、どれも指定されていない可能性があります。このエラーには、起動中のインスタンスが一覧表示されます。

DIALOG_OPEN — After Effects にダイアログが表示されています

After Effects にモーダルダイアログが表示されている間は、常駐エージェントも -r による起動も含め、スクリプトは一切実行されません。最もよくある原因は、フッテージやフォントが見つからないプロジェクトを開いた場合です（「このプロジェクトを最後に保存してから、N 個のファイルが見つかりません」）。このダイアログはメインウィンドウの背後に隠れていることもよくあります。エラーにはダイアログのテキストが表示されます（macOS の場合は以下を参照）。

• instance.dialogs には、起動中の各 After Effects に表示されているダイアログが一覧表示されます。
• instance.dismiss_dialog { id } は、ダイアログを Escape キーで閉じます。これはダイアログのキャンセル操作です。警告は確認され、「閉じる前に変更を保存しますか？」のような質問は、回答せずにキャンセルされます。保存も破棄も行われません。別の回答を選択したい場合は、ご自身でクリックする必要があります。
• ダイアログが閉じると、エージェントは自動的に再開します。再起動は不要です。
• ファイル不足の警告が最初から表示されないようにするには、プロジェクトを開かずに After Effects を起動し、project.open でプロジェクトを開いてください。これによりダイアログが抑制されます。

ダイアログの検出は Windows と macOS で機能します。macOS では、次の 2 段階で動作します。

• MCP サーバーを実行するアプリ（ターミナルまたは MCP クライアントアプリ）にアクセシビリティのアクセス許可を付与すると（システム設定 > プライバシーとセキュリティ > アクセシビリティ）、すべてのダイアログが検出され、テキストが読み取られます。また、instance.dismiss_dialog は Windows と同様に、Escape キーによるキャンセル操作として機能します。「閉じる前に変更を保存しますか？」という確認はキャンセルされ（プロジェクトは開いたままで、未保存の状態です）、警告やスクリプトの alert() は確認されます。After Effects が最前面に移動することはありません。
• このアクセス許可がない場合、ウィンドウ一覧を基にダイアログを推定します。多くのダイアログは検出されますが、テキストは空になります（accessibility: false）。ただし、Adobe ライセンス確認のような一部のダイアログは検出されず、ここから閉じることもできません。

After Effects 26.5 / macOS 26.4 で、ファイル不足の警告、スクリプトの alert()、保存確認、およびシステム互換性レポートを使って検証済みです。

After Effects が「クラッシュを検出しました」ダイアログで停止する場合

After Effects のプロセスが終了させられた場合（タスクマネージャー、taskkill、クラッシュなど）、次回の起動時にセーフモードのダイアログが表示され、クリックされるまで待機します。これには instance.start で起動したインスタンスも含まれ、その場合は did not register で失敗します。画面上でダイアログを閉じてください。正常に終了したインスタンスではこのダイアログは表示されないため、強制終了ではなく instance.stop を使用してください。

After Effects が見つからない場合

After Effects を標準以外の場所にインストールしている場合は、AE_MCP_EXE を設定してください。

問題が解決しない場合は、Issue または @cumuloworks までご報告ください。

開発者向け情報

内部 MCP ツール、After Effects との通信方法、ExtendScript、テスト環境、カスタム操作の追加方法については、開発者向けドキュメントをご覧ください。

• docs/TOOLS.md
• CONTRIBUTING.md

貢献

バグ報告、機能リクエスト、プルリクエストを歓迎します。

開発環境のセットアップ方法と内部アーキテクチャについては、CONTRIBUTING.md をご覧ください。

ライセンス

MIT © 2026 kumo.productions, Inc.

商標

Adobe® および Adobe After Effects® は Adobe Inc. の商標です。

このプロジェクトは独立した非公式ツールであり、Adobe とは提携しておらず、Adobe による推奨も受けていません。