AE-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.
关于这个版本 / About this build
本仓库是 ishu86/after-effects-mcp 的 Windows 实测分支, 在 AE 2024 (24.6.2) 上跑通全部 65 个工具,并修了一批上游的问题:
编码:
host.jsx读写统一 UTF-8,非 ASCII 转义为\uXXXX;file-communicator对响应做一次 URL 解码 → 中文项目名 / 图层名不再乱码get_layer_info:额外返回 effect 名称与参数值,排查特效参数不用再猜get_keyframes:补齐 in/out temporal ease 的speed/influencemodify_effect_properties:支持直接改 effect 的name(显示名)get_expression:修掉返回对象没被包成表达式体的 bug📘 给 agent 的连接教程(安装 / 各家客户端配置 / 探活 / 故障排查):
AGENT-CONNECT.md📘 AE 领域知识(属性路径、预设、常见坑):
SKILL/SKILL.md
Related MCP server: ae-mcp
Overview
AE-MCP is a comprehensive MCP server that enables AI assistants like Claude to directly control Adobe After Effects. It provides 65 tools covering the full motion graphics workflow — from creating compositions to applying professional effects and expressions.
Key Features
Feature | Description |
65 Tools | Complete After Effects automation |
Animation Presets | Spring physics, bounce, elastic, slide, fade |
Expression Library | 20+ pre-built expressions (wiggle, loop, physics) |
Effect Templates | One-click professional looks (cinematic, VHS, neon) |
Motion Graphics | Lower thirds, title cards, transitions, logo reveals |
Reliable Architecture | File-based communication for stability |
Requirements
Adobe After Effects 2024 or later
Node.js 18+
macOS or Windows
Installation
Step 1: Install the MCP Server
git clone https://github.com/Aite25/ae-mcp.git
cd ae-mcp
npm install
npm run buildStep 2: Install the CEP Extension
macOS:
./scripts/install-cep.shWindows:
scripts\install-cep.batStep 3: Configure Your AI Assistant
Add to your config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"ae-mcp": {
"command": "node",
"args": ["/path/to/ae-mcp/dist/index.js"]
}
}
}Add to your MCP settings (~/.claude/settings.json):
{
"mcpServers": {
"ae-mcp": {
"command": "node",
"args": ["/path/to/ae-mcp/dist/index.js"]
}
}
}Bonus: This repo includes a Claude Code Skill for enhanced After Effects automation. Copy the skill files to your Claude Code skills directory:
cp -r SKILL/* ~/.claude/skills/The Claude Code skill provides specialized knowledge about After Effects workflows, property formats, and best practices. See SKILL/SKILL.md for details.
Step 4: Launch After Effects
Start After Effects 2024+
Open Window > Extensions > AE-MCP
The panel will auto-start and begin listening for commands
Tool Categories
Project & Composition
create_project · open_project · save_project · close_project · get_project_info · import_footage · create_composition · modify_composition · duplicate_composition · delete_composition · list_compositions · get_composition_info
Layer Creation
add_solid_layer · add_text_layer · add_text_layer_advanced · add_shape_layer · add_null_layer · add_adjustment_layer · add_camera_layer · add_light_layer · add_av_layer · precompose_layers · modify_layer · delete_layer
Animation & Keyframing
set_keyframe · set_keyframe_advanced · apply_easy_ease · set_temporal_ease · offset_keyframes · scale_keyframe_timing · reverse_keyframes · copy_keyframes · get_keyframes
Expressions
set_expression · get_expression · remove_expression · enable_expression · add_expression_control · apply_expression_template · link_properties
Effects
apply_effect · apply_effect_template · modify_effect_properties · remove_effect · reorder_effects · copy_effects · list_effects
Motion Graphics Templates
Tool | Styles |
| modern, corporate, news, minimal, social |
| cinematic, documentary, social, minimal |
| wipe, dissolve, push, slide, zoom |
| fade, scale, slide, spin, glitch, particle |
| typewriter, fadeIn, scaleIn, slideIn, randomize, wave |
Asset Management
import_folder · replace_footage · organize_project_items · find_missing_footage · collect_files · reduce_project
Markers & Timeline
add_composition_marker · add_layer_marker · get_markers · delete_marker · set_work_area
Quick Examples
Create an animated intro
Create a 1920x1080 composition called "Intro" at 30fps, 5 seconds.
Add a text layer saying "Welcome" centered on screen.
Apply a slideInUp animation with easy ease.
Add a subtle glow effect.Build a lower third
Create a modern lower third:
- Name: "Sarah Chen"
- Title: "Lead Designer"
- Blue primary color
- Animate in and out
- 5 second durationAdd physics-based motion
Add a bounce expression to the position of "Logo" layer.
Set amplitude to 0.15, frequency to 4, decay to 6.Animation Presets
Spring Physics (Remotion-inspired)
Preset | Description |
| Subtle, smooth animations |
| Balanced spring motion |
| Playful, bouncy animations |
| Quick, responsive animations |
| Heavy, deliberate motion |
| High energy bounces |
| Instant, responsive feel |
Motion Presets
Fade: fadeIn · fadeOut
Slide: slideInLeft · slideInRight · slideInUp · slideInDown · slideOutLeft · slideOutRight · slideOutUp · slideOutDown
Scale: scaleIn · scaleOut · scaleInBounce
Physics: bounce · elastic · overshoot
Rotate: spinIn · spinOut
Expression Templates
Category | Templates |
Wiggle |
|
Loop |
|
Physics |
|
Linking |
|
Time |
|
Effect Templates
Category | Effects |
Blur |
|
Color |
|
Stylistic |
|
Creative |
|
Architecture
ae-mcp/
├── src/ # TypeScript source
│ ├── index.ts # Entry point
│ ├── stdio-server.ts # MCP server (65 tools)
│ ├── ae-integration/
│ │ ├── file-communicator.ts # File-based IPC
│ │ └── generators/ # ES3 script generators
│ └── presets/ # Animation, expression, effect presets
├── cep-extension/ # After Effects extension
│ ├── CSXS/manifest.xml
│ ├── jsx/host.jsx # ExtendScript host
│ └── js/main.js # Panel JavaScript
├── SKILL/ # Claude Code skill
│ ├── SKILL.md # Skill definition
│ └── examples.md # Animation examples
└── scripts/ # Installation scriptsCommunication Flow
AI Assistant (Claude)
↓
MCP Server (Node.js)
↓ Write JSON command
~/Documents/ae-mcp-commands/
↓ Poll every 100ms
CEP Extension
↓ Execute script
After Effects DOM
↓ Write response
*.json.responseTroubleshooting
Verify debug mode is enabled (the install script does this automatically)
Restart After Effects completely
Check extension location:
macOS:
~/Library/Application Support/Adobe/CEP/extensions/ae-mcpWindows:
%APPDATA%\Adobe\CEP\extensions\ae-mcp
Ensure the AE-MCP panel is visible in After Effects
Check
~/Documents/ae-mcp-commands/for command filesLook at the panel's log for errors
Open the ExtendScript Toolkit or console in After Effects
Verify composition/layer references exist
Check for ES3 compatibility issues (no arrow functions, template literals, etc.)
Contributing
Contributions are welcome! Please read our contributing guidelines before submitting PRs.
License
MIT
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
Video production studio for AI agents: AI media, motion graphics as code, timeline and export.
AI editor to build, animate & export layered short-form video projects via one tool catalog.
One sentence to a finished animation: your AI writes motion graphics as code and checks real frames.
Image and video AI tools and your own pipelines, run from any AI assistant.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control Adobe After Effects to create videos programmatically, with commands for comps, layers, effects, and rendering.8 npm28MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to operate Adobe After Effects with the dexterity of an editor: reading projects, creating and rigging layers, setting real velocity curves, animating text, building native SVG-based shapes, applying effects, expressions, masks, and viewing render snapshots to verify results.1718 npm1MIT
- 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.413766 npm3Apache 2.0
- AlicenseCqualityBmaintenanceEnables AI clients to control Adobe After Effects compositions, layers, 3D cameras, text animators, Bézier speed curves, effects/plugins, and asset imports, with frame snapshots, preview video export, automatic backup, and rollback.686MIT