After Effects MCP Server

io.github.zachshallbetter由 GitHub 帳號 zachshallbetter 發布v0.1.0更新於 Oct 27, 2026

Drive Adobe After Effects from any MCP client: compositions, layers, animation and rendering.

已驗證STDIO僅桌面效率與工作流媒體與設計

概覽

AI 產生的概覽

本機 MCP 伺服器，透過 ExtendScript 驅動 Adobe After Effects，讓助理建立合成、圖層、動畫、特效並進行算圖。

可以做什麼
  • 檢視與管理專案：專案資訊、素材項目、匯入素材、資料夾、儲存與開啟、缺少的相依項目與字型檢查
  • 建立與設定合成、標記、預合成，並匯出 PNG 影格
  • 新增、排列、建立父子關係、修剪、分割與刪除圖層，設定變形與圖層屬性
  • 設定屬性、關鍵影格、緩動與表示式，編輯或複製動畫
  • 套用特效與預設集、編輯特效控制項，並處理文字、遮罩、形狀、繪製與去背
  • 設定 3D 攝影機、燈光與材質、追蹤、色彩管理與音訊
適用情境
適合讓助理在同一台電腦上直接製作或修改 After Effects 動態圖像工作：組合成與圖層、為屬性做動畫、套用特效或排入算圖，而不必由使用者在介面中逐步操作。
執行需求
透過 npx 在本機執行（需 Node.js 18 或更新版本），macOS 或 Windows 上需安裝 After Effects 2023 或更新版本。macOS 首次呼叫需授予自動化權限；After Effects 中需允許指令碼寫入檔案與存取網路。選用變數：AFTEREFFECTS_ALLOWED_DIRS、AFTEREFFECTS_APP_NAME、AFTEREFFECTS_SCRIPT_TIMEOUT_MS、AFTEREFFECTS_EXE。
安裝前請注意
它會改動真實專案：相關工具可刪除圖層與素材項目、覆寫或儲存專案、替換素材、清除快取、結束應用程式並啟動會寫入檔案的算圖。檔案存取僅限家目錄及 AFTEREFFECTS_ALLOWED_DIRS，擴大該清單會暴露更多磁碟內容。它還提供執行任意 After Effects 程式碼的工具，並可將指令轉送到本機 EffectCraft 橋接。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 After Effects MCP Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

After Effects MCP Server

An MCP server that drives Adobe After Effects: projects and footage, compositions, layers, keyframes and expressions, effects, text, masks and the Render Queue. It runs on the machine where After Effects is installed and talks to it through ExtendScript, the scripting interface After Effects ships with.

Requires After Effects 2023 or later on macOS or Windows, and Node.js 18 or later.

Install

Claude Code:

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

Any client that reads an mcpServers block (Claude Desktop, Cursor, Warp, …):

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

On macOS the first call asks for permission to control After Effects (System Settings > Privacy & Security > Automation). In After Effects, turn on Settings > Scripting & Expressions > Allow Scripts to Write Files and Access Network, which file operations need.

Conventions

  • Compositions are chosen with comp: { id } (item ids come from list_items), { name }, or omitted for the active composition.
  • Layers are chosen with layers: { indexes: [...] } (1 = top, as in the Timeline), { names: [...] } or { selected: true }.
  • Properties are a shortcut (position, scale, rotation, opacity, anchor_point, source_text, …) or a path of match names or names, such as ["ADBE Effect Parade", "Gaussian Blur", "Blurriness"].
  • Positions are pixels from the composition's top-left; times are seconds; colours are "#RRGGBB" or "rgb(r,g,b)".
  • Files must be inside your home folder or a directory in AFTEREFFECTS_ALLOWED_DIRS.

Tools

AreaTools
Projectget_project_info, list_items, import_files (footage, sequences, layered files as compositions, projects), create_folder, manage_items (rename, move, label, delete), save_project, open_project (or a new project), tidy_project (remove unused, consolidate, reduce)
Compositionscreate_comp, set_comp_settings (size, duration, frame rate, resolution, start timecode, background, motion blur, nesting, work area, Timeline switches), create_comp_from_items (New Comp from Selection), duplicate_comp, precompose, open_comp, run_comp_command (trim, crop, poster time, lift and extract work area, flowchart, reveal), add_comp_marker, edit_markers (composition and layer markers, cue points, labels), save_frame (PNG)
Layerslist_layers, add_layer (solid, null, adjustment, text, shape, camera, light, or a project item), set_layer_properties (switches, comment, quality and sampling, blending mode, Auto-Orient, label, timing, stretch), set_transform, parent_layers (or with jump), set_track_matte, arrange_layers, duplicate_layers (or copy to another composition), delete_layers, select_layers, switch_all_layers, open_layer, trim_layers, move_layers (align, nudge, Quick Offset, slip), split_layers, reframe_layers (fit, centre, flip), replace_layer_source, set_solid_settings, set_layer_styles, choose_layer_tool
Timeremap_layer_time (time remapping, freeze frames), stretch_layers (time stretch, keeping keyframes, conform frame rate), set_frame_blending, align_video_to_data
Projectget_project_info, list_items, import_files (footage, sequences, layered files as compositions, projects, data files), create_folder, manage_items (rename, move, label, delete), save_project, save_project_copy (.aep or XML .aepx), open_project (a project, a template or a new project), run_project_command (close, revert, open most recent, increment and save), tidy_project (remove unused, consolidate, reduce), set_project_settings (time display, frame count, colour depth, expression engine, thumbnails), find_project_items, select_project_items, set_item_comment, find_missing_dependencies (footage, effects, fonts), resolve_project_fonts, edit_project_metadata (XMP)
Footageget_footage_info, interpret_footage (alpha, frame rate, fields, pulldown, pixel aspect, loop, copy an interpretation), replace_footage (file, sequence, placeholder, solid, layered comp), set_proxy, create_proxy, create_footage_item (placeholder or solid), reload_footage, open_footage (Footage panel, Finder or Explorer, Bridge, Edit Original), detect_scene_edits, paste_svg_as_shapes
Compositionscreate_comp, set_comp_settings (size, duration, frame rate, background, motion blur, work area), duplicate_comp, precompose, open_comp, add_comp_marker, save_frame (PNG)
Layerslist_layers, add_layer (solid, null, adjustment, text, shape, camera, light, or a project item), set_layer_properties (switches, quality, blending mode, label, timing, stretch), set_transform, parent_layers, set_track_matte, arrange_layers, duplicate_layers (or copy to another composition), delete_layers
Animationget_property, set_property, set_keyframes (interpolation and easing), remove_keyframes, set_expression, convert_expression_to_keyframes, set_expression_engine (JavaScript or Legacy ExtendScript)
Keyframesedit_keyframes (Easy Ease, Auto and Continuous Bezier, Hold, ease speed and influence, motion path tangents, roving, labels, values, time-reverse), select_keyframes, go_to_keyframe, copy_animation (keyframes, reversed, expression only, or property links), separate_dimensions, sequence_layers, run_animation_command (keyframe selection, Keyframe Assistant and Reveal commands), manage_puppet (Puppet effect, pin tools, meshes)
Effectslist_effects, apply_effect (with property values), list_layer_effects, remove_effects (or turn off), apply_preset (.ffx)
Textadd_text_layer (point or paragraph, horizontal or vertical), set_text (Source Text and Character and Paragraph formatting, for the layer or a range of characters or paragraphs), get_text, find_fonts, set_font_options (favourites, font folder rescan), set_text_options (Path Options, More Options, per-character 3D), set_text_animator (animator properties, variable font axes, Range, Wiggly and Expression selectors), list_text_animators, remove_text_animators, convert_text_layers (Create Shapes or Masks from Text, Convert to Editable Text), show_text_panels
Effect controlsfind_effects (the effect catalog by category, with each effect's controls and whether it is installed), set_effect_controls (apply any effect and set its controls by name, or edit an applied one; keyframes with time), get_effect_controls (types, values, menu choices, ranges), organize_effects (duplicate, reorder, copy to other layers)
Textset_text (Source Text and Character and Paragraph formatting)
Masksadd_mask (rectangle, ellipse or path, with mode, feather, opacity, expansion), list_masks, set_masks (mode, lock, lock others, colour, RotoBezier, motion blur, feather falloff), manage_masks (delete, remove all, duplicate, select next or previous, hide locked, mask reference on an effect), set_bezier_path (mask or shape path vertices, first vertex, direction, free transform, variable-width feather points)
Shapeslist_shape_content, add_shape_content (groups, rectangle, ellipse, polystar, path, fill, stroke, gradients, and Merge Paths, Offset Paths, Pucker & Bloat, Repeater, Round Corners, Trim Paths, Twist, Wiggle Paths, Wiggle Transform, Zig Zag with their settings), set_shape_content (transform, blend mode, line cap and join, dashes, taper, wave, fill rule, composite, gradient points, operator settings), arrange_shape_content (delete, duplicate, move, group, ungroup, convert to Bezier path), create_shapes_from_vector_layer
Paint and rotoselect_drawing_tool (shape, pen, mask feather, brush, clone stamp, eraser, Roto Brush and Refine Edge tools; Paint, Brushes and Content-Aware Fill panels), list_paint_strokes, set_paint_strokes (stroke and clone settings, keyframed), set_roto_brush (Roto Brush & Refine Edge settings)
3Dset_camera_options (zoom, F-Stop, depth of field, iris, highlights, Point of Interest), set_light_options (type, colour, intensity, cone, falloff, shadows, environment source), set_material_options (shadows, lights, reflections, transparency; environment layer), set_geometry_options (bevel, extrusion, curvature), set_comp_3d_settings (3D renderer, Draft 3D), set_3d_view (View > Switch 3D View, Reset, Look at, Create Camera from 3D View), run_camera_command (focus links, orbit null, stereo rig, cameras and lights from 3D models), set_camera_tool
Renderlist_render_templates, queue_render (a span, one frame, or a pre-render), get_render_item, set_render_settings (template and every Render Settings option, log, notification), set_output_module (template or format, file and file name template, channels, depth, resize, crop, audio, post-render action; add or remove modules), render_queue (in After Effects or Adobe Media Encoder), manage_render_queue (remove, duplicate, turn on and off), control_render_queue (pause, continue, stop, panel, progress), configure_render_engine (Multi-Frame Rendering, Watch Folder)
Essential Graphicsset_essential_graphics (primary composition, template and control names), add_essential_graphics_controls (properties, dropdown menus, media replacement), add_protected_region (Responsive Design - Time), export_motion_graphics_template (.mogrt)
Renderlist_render_templates, queue_render, render_queue (in After Effects or Adobe Media Encoder), manage_render_queue
Trackingstart_tracking (Track Motion, Track Mask, Track this Property, Mocha, Tracker panel, Motion Tracking workspace), apply_warp_stabilizer, apply_camera_tracker (3D Camera Tracker), get_tracking_data (track points, face measurements), set_track_point
Colourget_color_management (and colour profiles), set_color_management (bit depth, working space, gamma, linearize, blending), set_display_color (display colour management, Simulate Output, Lumetri Scopes), apply_color_effect (grading, broadcast-safe, output simulation on an adjustment layer)
Applicationpurge_caches (Edit > Purge), run_edit_command (undo, redo, cut, copy, paste, select), get_aftereffects_info (version, system, GPU, preference values), set_application_settings (memory, GPU acceleration, documented preferences), manage_script_settings, quit_aftereffects
Interfaceget_viewer_state, set_view_options (zoom, resolution, channels, exposure, Fast Previews, rulers, guides), run_view_command (grid, layouts, new or close viewer), edit_comp_guides, set_current_tool, go_to_time, show_panel, switch_workspace
Audioset_audio_levels, remap_layer_speed (speed and pitch), run_audio_command (Convert Audio to Keyframes, Edit in Adobe Audition)
Automationrun_aftereffects_script_file (now, scheduled, or from File > Scripts), manage_motion_graphics_template
Collaborationmanage_team_project (status, create, open, share, get latest, resolve, convert, close)
Utilityaftereffects_status, run_menu_command, execute_aftereffects_code, help

help({ tool }) describes any tool's parameters.

How it stays out of your way

  • No dialogs. Every script runs with After Effects' dialogs suppressed.
  • One undo step per call. Each call that changes the project is one entry in Edit > Undo.
  • Windows without COM. After Effects has no COM interface, so on Windows the server hands scripts to AfterFX.exe -r and reads the result back from a file. Set AFTEREFFECTS_EXE if After Effects is not in the default location.
  • Timeouts say why. If After Effects does not answer within AFTEREFFECTS_SCRIPT_TIMEOUT_MS (default 120 s), the error says a dialog is probably open. Raise it for long renders.
  • No raw input in scripts. Every value a caller passes is validated and written into the script as a literal.

Configuration

VariablePurpose
AFTEREFFECTS_APP_NAMEmacOS: address a specific copy, e.g. Adobe After Effects 2025. By default the server addresses After Effects by its bundle id.
AFTEREFFECTS_EXEWindows: path to AfterFX.exe.
AFTEREFFECTS_ALLOWED_DIRSExtra directories for importing, saving and rendering (:-separated on macOS, ; on Windows).
AFTEREFFECTS_SCRIPT_TIMEOUT_MSHow long to wait for After Effects. Default 120000.
AFTEREFFECTS_TARGETSet to craft to route commands to EffectCraft.
EFFECTCRAFT_CONTROL_PORTPort for EffectCraft bridge (default 9877).

ArtCraft (EffectCraft) Support

This server features transparent adapter support for Storytold's EffectCraft motion graphics application. When After Effects is not installed or running, or when AFTEREFFECTS_TARGET=craft (or ADOBE_TARGET=craft) is set, compatible tools route directly to EffectCraft's loopback bridge protocol (127.0.0.1:9877 by default or EFFECTCRAFT_CONTROL_PORT).

Development

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

src/data/effects.json is the effect catalog, built from the capability atlas with node scripts/update-effects.js <path to adobe-capability-atlas>.

The audit checks each generated script against After Effects' scripting object model (types-for-adobe, After Effects 26.0). Nothing is validated against After Effects itself yet.

來源：packages/aftereffects/README.md，提交 44b5b50

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Oct 20, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分