After Effects MCP Server

After Effects MCP Server

Adobe After Effects を操作する MCP サーバーです。プロジェクトとフッテージ、 コンポジション、レイヤー、キーフレームとエクスプレッション、エフェクト、テキスト、マスク、そして レンダーキューを操作します。After Effects がインストールされているマシン上で動作し、 After Effects に付属するスクリプティングインターフェイスの ExtendScript を通じて After Effects と通信します。

macOS または Windows で After Effects 2023 以降、および Node.js 18 以降が必要です。

インストール

Claude Code：

claude mcp add aftereffects -- npx -y adobe-mcp-aftereffects

mcpServers ブロックを読み取る任意のクライアント（Claude Desktop、Cursor、Warp、…）：

{
  "mcpServers": {
    "aftereffects": {
      "command": "npx",
      "args": ["-y", "adobe-mcp-aftereffects"]
    }
  }
}

macOS では、最初の呼び出し時に After Effects の操作許可を求められます（システム設定 > プライバシーとセキュリティ > オートメーション）。 After Effects で「設定 > スクリプトとエクスプレッション > スクリプトによるファイルの書き込みとネットワークへのアクセスを許可」を有効にしてください。ファイル操作に必要です。

規則

• コンポジションは comp で選択します。{ id }（アイテム ID は list_items で取得できます）、{ name }、または省略してアクティブなコンポジションを指定します。
• レイヤーは layers で選択します。{ indexes: [...] }（タイムラインと同様に、 1 が最上部）、{ names: [...] }、または { selected: true } を指定します。
• プロパティはショートカット（position、scale、rotation、opacity、 anchor_point、source_text、…）か、マッチ名または名前のパスです。例： ["ADBE Effect Parade", "Gaussian Blur", "Blurriness"]。
• 位置はコンポジションの左上からのピクセル数です。時間は 秒単位です。色は "#RRGGBB" または "rgb(r,g,b)" です。
• ファイルは、ホームフォルダー内、または AFTEREFFECTS_ALLOWED_DIRS に指定されたディレクトリ内にある必要があります。

ツール

領域	ツール
プロジェクト	get_project_info、list_items、import_files（フッテージ、シーケンス、コンポジションとしてのレイヤー化ファイル、プロジェクト）、create_folder、manage_items（名前変更、移動、ラベル付け、削除）、save_project、open_project（または新規プロジェクト）、tidy_project（未使用項目の削除、統合、縮小）
コンポジション	create_comp、set_comp_settings（サイズ、デュレーション、フレームレート、解像度、開始タイムコード、背景、モーションブラー、ネスト、作業領域、タイムラインのスイッチ）、create_comp_from_items（選択範囲から新規コンポジションを作成）、duplicate_comp、precompose、open_comp、run_comp_command（トリム、クロップ、ポスター時間、作業領域のリフトと抽出、フローチャート、表示）、add_comp_marker、edit_markers（コンポジションとレイヤーのマーカー、キューポイント、ラベル）、save_frame（PNG）
レイヤー	list_layers、add_layer（平面、ヌル、調整、テキスト、シェイプ、カメラ、ライト、またはプロジェクト項目）、set_layer_properties（スイッチ、コメント、画質とサンプリング、描画モード、自動方向、ラベル、タイミング、伸縮）、set_transform、parent_layers（またはジャンプ付き）、set_track_matte、arrange_layers、duplicate_layers（または別のコンポジションにコピー）、delete_layers、select_layers、switch_all_layers、open_layer、trim_layers、move_layers（整列、微調整、クイックオフセット、スリップ）、split_layers、reframe_layers（フィット、中央揃え、反転）、replace_layer_source、set_solid_settings、set_layer_styles、choose_layer_tool
時間	remap_layer_time（タイムリマップ、フリーズフレーム）、stretch_layers（キーフレームの維持、フレームレートに合わせた調整を含む時間伸縮）、set_frame_blending、align_video_to_data
プロジェクト	get_project_info、list_items、import_files（フッテージ、シーケンス、コンポジションとしてのレイヤー化ファイル、プロジェクト、データファイル）、create_folder、manage_items（名前変更、移動、ラベル付け、削除）、save_project、save_project_copy（.aep または XML .aepx）、open_project（プロジェクト、テンプレート、または新規プロジェクト）、run_project_command（閉じる、復帰、最新のプロジェクトを開く、番号を増やして保存）、tidy_project（未使用項目の削除、統合、縮小）、set_project_settings（時間表示、フレーム数、色深度、エクスプレッションエンジン、サムネイル）、find_project_items、select_project_items、set_item_comment、find_missing_dependencies（フッテージ、エフェクト、フォント）、resolve_project_fonts、edit_project_metadata（XMP）
フッテージ	get_footage_info、interpret_footage（アルファ、フレームレート、フィールド、プルダウン、ピクセル縦横比、ループ、フッテージ解釈のコピー）、replace_footage（ファイル、シーケンス、プレースホルダー、平面、レイヤー化コンポジション）、set_proxy、create_proxy、create_footage_item（プレースホルダーまたは平面）、reload_footage、open_footage（フッテージパネル、Finder または Explorer、Bridge、オリジナルを編集）、detect_scene_edits、paste_svg_as_shapes
コンポジション	create_comp、set_comp_settings（サイズ、デュレーション、フレームレート、背景、モーションブラー、作業領域）、duplicate_comp、precompose、open_comp、add_comp_marker、save_frame（PNG）
レイヤー	list_layers、add_layer（平面、ヌル、調整、テキスト、シェイプ、カメラ、ライト、またはプロジェクト項目）、set_layer_properties（スイッチ、画質、描画モード、ラベル、タイミング、伸縮）、set_transform、parent_layers、set_track_matte、arrange_layers、duplicate_layers（または別のコンポジションにコピー）、delete_layers
アニメーション	get_property、set_property、set_keyframes（補間とイージング）、remove_keyframes、set_expression、convert_expression_to_keyframes、set_expression_engine（JavaScript または従来の ExtendScript）
キーフレーム	edit_keyframes（イージーイーズ、自動および連続ベジェ、ホールド、イーズ速度と影響度、モーションパスの接線、ロービング、ラベル、値、時間反転）、select_keyframes、go_to_keyframe、copy_animation（キーフレーム、逆再生、エクスプレッションのみ、またはプロパティリンク）、separate_dimensions、sequence_layers、run_animation_command（キーフレームの選択、キーフレーム補助、表示コマンド）、manage_puppet（パペットエフェクト、ピンツール、メッシュ）
エフェクト	list_effects、apply_effect（プロパティ値を指定）、list_layer_effects、remove_effects（またはオフにする）、apply_preset（.ffx）
テキスト	add_text_layer（ポイントテキストまたは段落テキスト、横書きまたは縦書き）、set_text（ソーステキストと文字および段落の書式設定を、レイヤー全体または文字や段落の範囲に適用）、get_text、find_fonts、set_font_options（お気に入り、フォントフォルダーの再スキャン）、set_text_options（パスオプション、その他のオプション、文字ごとの 3D）、set_text_animator（アニメーターのプロパティ、可変フォント軸、範囲、ウィグリーセレクター、エクスプレッションセレクター）、list_text_animators、remove_text_animators、convert_text_layers（テキストからシェイプまたはマスクを作成、編集可能なテキストに変換）、show_text_panels
エフェクトコントロール	find_effects（カテゴリー別のエフェクトカタログ。各エフェクトのコントロールとインストール状況を表示）、set_effect_controls（任意のエフェクトを適用して名前でコントロールを設定、または適用済みのエフェクトを編集。キーフレームには time を指定）、get_effect_controls（種類、値、メニューの選択肢、範囲）、organize_effects（複製、並べ替え、他のレイヤーへのコピー）
テキスト	set_text（ソーステキストと文字および段落の書式設定）
マスク	add_mask（長方形、楕円形、またはパス。モード、ぼかし、不透明度、拡張を指定）、list_masks、set_masks（モード、ロック、他のマスクをロック、カラー、ロトベジェ、モーションブラー、ぼかしの減衰）、manage_masks（削除、すべて削除、複製、次または前を選択、ロックされたマスクを非表示、エフェクト上のマスクリファレンス）、set_bezier_path（マスクまたはシェイプのパス頂点、最初の頂点、方向、自由変形、可変幅のぼかしポイント）
シェイプ	list_shape_content、add_shape_content（グループ、長方形、楕円形、ポリスター、パス、塗り、線、グラデーション、およびパスの結合、パスのオフセット、収縮・膨張、リピーター、角を丸くする、パスのトリミング、ツイスト、パスのウィグル、ウィグル変形、ジグザグとそれぞれの設定）、set_shape_content（トランスフォーム、描画モード、線端と線の結合、破線、テーパー、波形、塗りルール、合成、グラデーションポイント、演算子の設定）、arrange_shape_content（削除、複製、移動、グループ化、グループ解除、ベジェパスに変換）、create_shapes_from_vector_layer
ペイントとロト	select_drawing_tool（シェイプ、ペン、マスクのぼかし、ブラシ、スタンプ、消しゴム、ロトブラシ、エッジを調整ツール。ペイント、ブラシ、コンテンツに応じた塗りつぶしパネル）、list_paint_strokes、set_paint_strokes（ストロークとスタンプの設定、キーフレーム対応）、set_roto_brush（ロトブラシとエッジを調整の設定）
3D	set_camera_options（ズーム、F値、被写界深度、絞り、ハイライト、注視点）、set_light_options（種類、カラー、強度、円錐、減衰、シャドウ、環境ソース）、set_material_options（シャドウ、ライト、反射、透明度。環境レイヤー）、set_geometry_options（ベベル、押し出し、曲率）、set_comp_3d_settings（3D レンダラー、ドラフト 3D）、set_3d_view（ビュー > 3D ビューを切り替え、リセット、注視、3D ビューからカメラを作成）、run_camera_command（フォーカスリンク、軌道ヌル、ステレオリグ、3D モデルからカメラとライトを作成）、set_camera_tool
レンダリング	list_render_templates、queue_render（範囲、1 フレーム、またはプリレンダー）、get_render_item、set_render_settings（テンプレートとすべてのレンダー設定オプション、ログ、通知）、set_output_module（テンプレートまたは形式、ファイルとファイル名のテンプレート、チャンネル、ビット深度、サイズ変更、クロップ、オーディオ、レンダー後のアクション。モジュールの追加または削除）、render_queue（After Effects または Adobe Media Encoder で）、manage_render_queue（削除、複製、オンとオフの切り替え）、control_render_queue（一時停止、続行、停止、パネル、進行状況）、configure_render_engine（マルチフレームレンダリング、監視フォルダー）
エッセンシャルグラフィックス	set_essential_graphics（プライマリコンポジション、テンプレート、コントロール名）、add_essential_graphics_controls（プロパティ、ドロップダウンメニュー、メディアの置き換え）、add_protected_region（レスポンシブデザイン - 時間）、export_motion_graphics_template（.mogrt）
レンダリング	list_render_templates、queue_render、render_queue（After Effects または Adobe Media Encoder で）、manage_render_queue
トラッキング	start_tracking（モーションをトラック、マスクをトラック、このプロパティをトラック、Mocha、トラッカーパネル、モーショントラッキングワークスペース）、apply_warp_stabilizer、apply_camera_tracker（3D カメラトラッカー）、get_tracking_data（トラックポイント、顔の計測値）、set_track_point
カラー	get_color_management（およびカラープロファイル）、set_color_management（ビット深度、作業スペース、ガンマ、リニア化、ブレンド）、set_display_color（ディスプレイカラーマネジメント、出力をシミュレート、Lumetri スコープ）、apply_color_effect（調整レイヤーでのカラーグレーディング、放送規格に準拠した色、出力シミュレーション）
アプリケーション	purge_caches（編集 > 消去）、run_edit_command（取り消し、やり直し、カット、コピー、ペースト、選択）、get_aftereffects_info（バージョン、システム、GPU、環境設定値）、set_application_settings（メモリ、GPU アクセラレーション、ドキュメント化された環境設定）、manage_script_settings、quit_aftereffects
インターフェイス	get_viewer_state、set_view_options（ズーム、解像度、チャンネル、露出、高速プレビュー、ルーラー、ガイド）、run_view_command（グリッド、レイアウト、新しいビューアまたはビューアを閉じる）、edit_comp_guides、set_current_tool、go_to_time、show_panel、switch_workspace
オーディオ	set_audio_levels、remap_layer_speed（速度とピッチ）、run_audio_command（オーディオをキーフレームに変換、Adobe Audition で編集）
自動化	run_aftereffects_script_file（即時、スケジュール実行、またはファイル > スクリプトから実行）、manage_motion_graphics_template
コラボレーション	manage_team_project（ステータス、作成、開く、共有、最新の状態を取得、解決、変換、閉じる）
ユーティリティ	aftereffects_status、run_menu_command、execute_aftereffects_code、help
help({ tool }) では、任意のツールのパラメーターを確認できます。

操作を妨げない仕組み

• ダイアログを表示しません。 すべてのスクリプトの実行中は、After Effects のダイアログが抑制されます。
• 呼び出しごとに 1 回の取り消し操作。 プロジェクトを変更する各呼び出しは、「編集」>「取り消し」に 1 つの項目として記録されます。
• Windows では COM を使用しません。 After Effects には COM インターフェイスがないため、Windows ではサーバーが AfterFX.exe -r にスクリプトを渡し、ファイルから結果を読み取ります。After Effects が既定の場所にない場合は、AFTEREFFECTS_EXE を設定してください。
• タイムアウトの理由を示します。 After Effects が AFTEREFFECTS_SCRIPT_TIMEOUT_MS（既定値は 120 s）以内に応答しない場合、エラーにはダイアログが開いている可能性が高いことが示されます。レンダリングに時間がかかる場合は、値を大きくしてください。
• スクリプトに生の入力を含めません。 呼び出し元から渡された値はすべて検証され、リテラルとしてスクリプトに書き込まれます。

設定

変数	用途
AFTEREFFECTS_APP_NAME	macOS：特定のコピーを指定します。例：Adobe After Effects 2025。既定では、サーバーはバンドル ID で After Effects を指定します。
AFTEREFFECTS_EXE	Windows：AfterFX.exe へのパスです。
AFTEREFFECTS_ALLOWED_DIRS	読み込み、保存、レンダリングに使用する追加ディレクトリ（macOS では : 区切り、Windows では ; 区切り）です。
AFTEREFFECTS_SCRIPT_TIMEOUT_MS	After Effects の応答を待つ時間です。既定値は 120000 です。
AFTEREFFECTS_TARGET	EffectCraft にコマンドをルーティングするには、craft を設定します。
EFFECTCRAFT_CONTROL_PORT	EffectCraft ブリッジのポートです（既定値は 9877）。

ArtCraft（EffectCraft）のサポート

このサーバーは、Storytold のモーショングラフィックスアプリケーション EffectCraft に透過的なアダプターサポートを提供します。After Effects がインストールされていない場合や起動していない場合、または AFTEREFFECTS_TARGET=craft（あるいは ADOBE_TARGET=craft）が設定されている場合、互換性のあるツールは EffectCraft のループバックブリッジプロトコル（既定では 127.0.0.1:9877、または EFFECTCRAFT_CONTROL_PORT）に直接ルーティングされます。

開発

npm test         # definitions, argument parsing, protocol, and the static script audit
npm run audit    # the audit alone, with findings listed
npm run check    # syntax check

src/data/effects.json はエフェクトカタログです。次のコマンドで、機能アトラスから作成されます。 node scripts/update-effects.js <path to adobe-capability-atlas>

監査では、生成された各スクリプトを After Effects のスクリプティングオブジェクトモデル（types-for-adobe、After Effects 26.0）と照合します。現時点では、After Effects 自体を対象とした検証は行われません。