ae-mcp

English | 简体中文

Automatic setup: paste this prompt into the MCP client you want to use

Install and configure ae-mcp for the current client receiving and executing
this prompt. Do not default to Claude Code or configure another client.
Before changing anything, inspect the local ae-mcp extension and native plug-in
files and versions, plus this client's existing MCP registration and actual
connection, read-only. Existence alone does not prove readiness. Compare with
the latest official stable release assets available for my platform:
- Client registration already correct: keep it; install only missing or damaged files.
- Files complete and versions suitable: only add or repair client registration.
- Both ready and current: verify without reinstalling.
- Newer version available: upgrade existing components, preserving user settings
  and other MCP configuration; do not downgrade. If versions cannot be established
  or platform assets are unavailable, explain rather than blindly overwrite.
Use the release ZXP and platform-native plug-in for needed file installation or
upgrade, then open Window > Extensions > ae-mcp in After Effects.
Identify this client's configuration method and location, preserving all other
MCP entries. Use http://127.0.0.1:11488/mcp if it supports Streamable HTTP;
for stdio only, configure `npx -y ae-mcp-jkdg` using this client's format.
If automatic editing is unavailable, give precise manual steps for this client.
Ask which client only if the target truly cannot be identified; never silently
fall back to Claude Code. Keep the AE panel open, refresh/reconnect or start a
new session as this client requires, then call ae_status to verify. If user
action is required first, state that verification is still pending.

Let AI read your After Effects project, build animations, inspect the results, and save successful operations as reusable tools.

ae-mcp is an open-source CEP extension that connects a running After Effects project to the Model Context Protocol (MCP). Chat with Claude, Codex, or OpenCode inside the panel, or connect an external MCP client to work with compositions, layers, keyframes, and expressions.

Download v0.11.0 · Install · Tool reference · Changelog

What it does

• Read real project state: inspect projects, compositions, layers, properties, and keyframes with pagination, sorting, and filtering.
• Build and edit animations: run ExtendScript for general AE operations; use native AEGP tools for exact time and object locators.
• Inspect composition pixels: export PNG frames from AE, sample multiple times in a grid, and compare A/B pixel differences.
• Recover failed operations: use checkpoints of saved projects, captured failure scripts, and a recoveryId to inspect, correct, or restore state.
• Keep reusable tools: successful scripts become replayable candidates that can be saved, pinned, archived, exported, and imported; prompt skills are supported too.
• Follow execution: use the panel's approvals, activity timeline, conversation history, and diagnostic export.

The workflow is read → execute → preview → correct → save for reuse. The AI reads current state through the AE host, including unsaved changes, and checks results using both project structure and composition previews.

A complete workflow