AE Control MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
AE Control MCP
A Model Context Protocol (MCP) server and Antigravity plugin that bridges AI coding agents with Adobe After Effects 2020 and Windows desktop automation using a safe, non-destructive, script-first workflow.
Instead of directly mutating or overwriting a user's .aep project file, ae-control-mcp inspects compositions read-only, validates 2D layout geometry, renders clean frame previews, and generates standalone ES3 ExtendScript (.jsx) files that the artist reviews and executes manually in After Effects.
Why Script-First?
Direct AI edits to live motion-graphics projects are risky: a wrong keyframe or accidental save can corrupt hours of manual work. AE Control MCP enforces a strict safety boundary by design:
Read-Only Project Inspection — Inspects open compositions, layers, types, timings, bounding boxes, and exact rendered frames without modifying the
.aepfile.Safe
.jsxScript Generation (ae_write_script) — Writes UTF-8 (with BOM) ES3 scripts wrapped inapp.beginUndoGroup(...) / try...catch...finally, with built-in ES3/safety linting that flags ES6+ syntax (let/const/=>/template literals) and accidentalapp.project.save()calls.Human-in-the-Loop Execution — The user runs the generated
.jsxvia File → Scripts → Run Script File..., can undo everything in a singleCtrl+Z, and saves (Ctrl+S) only when satisfied.Protected Artifact Cleanup (
ae_cleanup_artifacts) — Cleans up temporary screenshots, preview frames, and leftoverae_mcp_*/ae_frame_*temp directories while strictly protecting.jsx,.aep,.prproj,.psd,.ai, and.ffxfiles.
Related MCP server: AE Bridge MCP
Architecture
flowchart LR
Agent["AI Agent / Antigravity"] <-->|MCP stdio| Server["FastMCP Server (server.py)"]
Server --> AE["After Effects Bridge (after_effects.py)"]
Server --> Geo["SOLID Layout Analyzer (geometry/)"]
Server --> GUI["DPI-Aware Windows GUI (gui.py)"]
AE -->|"Read-only ES3 + atomic sentinel"| AE2020["Adobe After Effects 2020"]
AE -->|"Headless render"| Render["aerender.exe"]
AE -->|"UTF-8 BOM + UndoGroup"| JSX["Standalone .jsx Scripts"]
Geo --> AEEngineering Highlights
Reliable Windows AE 2020 IPC Bridge:
Handles the Windows single-instance quirk where
AfterFX.exe -r script.jsxhands off execution to a running After Effects process and exits immediately with code1before the script finishes.Uses an atomic result +
.donesentinel file protocol with Windows file-lock (WinError 32) retry handling and custom ES3 JSON serialization (since AE 2020 ExtendScript has no nativeJSON.stringify).Handles asynchronous
comp.saveFrameToPng()rendering by polling until the output PNG is completely written, unlocked, and decodable by Pillow.Encodes scripts in UTF-8 with BOM so AE 2020 on Windows handles Cyrillic and Unicode layer/text names cleanly.
SOLID Spatial Geometry Analyzer (
src/ae_control_mcp/geometry/):Protocol-driven architecture (
ScriptRunner,GeometryProvider,LayoutRule) decoupled from After Effects for fast offline unit testing.Evaluates Bounds Check (out-of-frame & clipped edges), Title-Safe Margins (text proximity to frame edges), and Layer Overlaps — accounting for layer rotation, negative scale, anchor points, and timeline visibility.
DPI-Aware Windows GUI Automation (
src/ae_control_mcp/gui.py):Enables
PROCESS_PER_MONITOR_DPI_AWAREso screenshot coordinates map 1:1 to physical screen pixels.Supports
target_windowbounds enforcement to prevent stray clicks outside the intended application, PyAutoGUI corner fail-safe, and clipboard-backed Unicode/Cyrillic typing.
MCP Tools Reference
After Effects 2020 (Read-Only, Script Generation & Cleanup)
Tool | Description |
| Read-only inspection of the active AE project, compositions, layers, types, and timings. |
| Writes an ES3 |
| Removes temporary screenshots, preview frames, and leftover |
| Extracts live 2D layer geometry from AE 2020 and runs bounds, title-safe, and overlap rules. |
| Runs the same spatial layout rules offline on raw JSON geometry (no AE required). |
| Renders an exact composition frame via |
| Headlessly renders a saved |
Windows GUI Automation
Tool | Description |
| DPI-aware full-screen or window-cropped capture with coordinate-mapping metadata ( |
| Returns primary display dimensions in physical pixels. |
| Lists open desktop windows with bounds and brings a target window to the foreground. |
| Mouse automation with optional |
| Unicode/Cyrillic-safe text input and hotkey combinations. |
Quick Start
Prerequisites
Windows 10/11
Python 3.11+ and
uvAdobe After Effects 2020 with scripting file access enabled:
Edit → Preferences → Scripting & Expressions → Allow Scripts to Write Files and Access Network
Installation
git clone https://github.com/SolomonJSX/ae-control-mcp.git
cd ae-control-mcp
powershell -ExecutionPolicy Bypass -File .\scripts\install_plugin.ps1install_plugin.ps1 automatically:
Creates or repairs the local
.venvviauv sync.Auto-detects Adobe After Effects 2020 (
AfterFX.exe&aerender.exe).Installs the Antigravity plugin bundle (
plugin.json,mcp_config.json,rules/AGENTS.md,skills/ae-control/SKILL.md) into%USERPROFILE%\.gemini\config\plugins\ae-control\.
To specify a custom After Effects path manually:
powershell -ExecutionPolicy Bypass -File .\scripts\install_plugin.ps1 -AeExePath "D:\Adobe\AE 2020\Support Files\AfterFX.exe"Project Structure
ae-control-mcp/
├── src/ae_control_mcp/
│ ├── server.py # FastMCP server & tool registration
│ ├── after_effects.py # AE 2020 ExtendScript bridge, .jsx writer, cleanup & aerender
│ ├── ae_geometry.py # AE layer bounding-box extractor
│ ├── gui.py # DPI-aware Windows screenshot, mouse & keyboard control
│ ├── protocols.py # SOLID interfaces (ScriptRunner, GeometryProvider, LayoutRule)
│ └── geometry/
│ ├── models.py # Immutable geometry & layout report dataclasses
│ └── analyzers.py # Bounds, title-safe, and overlap rules
├── plugin/ # Antigravity plugin bundle (manifest, rules, skill, MCP config)
├── scripts/
│ └── install_plugin.ps1 # One-command setup & plugin installer
├── tests/ # Unit test suite (20 tests, fully mocked / offline)
├── pyproject.toml
└── uv.lockRunning Tests
The test suite mocks After Effects and Windows GUI APIs so all tests run fast and offline:
uv run python -m unittest discover -s tests -vLicense
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Reach your own computers from any AI app: files, commands, screen and mouse, approvals and alerts.
Build and run visual creative-production workflows from your AI agent.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to control Adobe After Effects for project inspection, composition creation, and layer manipulation via a hardened bridge panel.-
- AlicenseAqualityAmaintenanceEnables AI agents to inspect and control a live Adobe After Effects session, including reading active composition and layer data and evaluating arbitrary ExtendScript.4MIT
- AlicenseNot gradedqualityCmaintenanceConnects LLMs and agentic assistants directly to an active Adobe After Effects session on Windows, enabling composition inspection, parametric motion graphics, keyframe injection, vector masks, audio beat analysis, and automated rotoscoping.MIT
- AlicenseAqualityBmaintenanceLets AI agents drive a running Adobe After Effects (~270 undo-safe operations). Works with every UI language Adobe ships and sees the frame: draws Object Matte on what it sees (lassos, ⊕/⊖ points, a preview of gaps and people) and syncs AI-generated layers with the plate frame by frame. A large skills library, built for AI and generative features: Roto Brush, Object Matte, Content-Aware Fill.413232 npm4Apache 2.0