Skip to content
Back to search

ae-mcp

Adobe After Effects MCP server (65 tools): stdio MCP + CEP file-bridge, tested on AE 2024 / Windows. Includes a CN agent connection guide.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aite25--ae-mcp/badge.svg)](/listings/aite25--ae-mcp)

HTML

<a href="/listings/aite25--ae-mcp"><img src="/api/listings/aite25--ae-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Step 1: Install the MCP Server

git clone https://github.com/Aite25/ae-mcp.git
cd ae-mcp
npm install
npm run build

Step 2: Install the CEP Extension

**macOS:**

./scripts/install-cep.sh

**Windows:**

scripts\install-cep.bat

Step 3: Configure Your AI Assistant

<details> <summary><strong>Claude Desktop</strong></summary>

Add to your config file: - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

{
  "mcpServers": {
    "ae-mcp": {
      "command": "node",
      "args": ["/path/to/ae-mcp/dist/index.js"]
    }
  }
}

</details>

<details> <summary><strong>Claude Code (CLI)</strong></summary>

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`](SKILL/SKILL.md) for details. </details>

Step 4: Launch After Effects

1. Start **After Effects 2024+** 2. Open **Window > Extensions > AE-MCP** 3. The panel will auto-start and begin listening for commands

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 323 lines
  1. <p align="center">
  2. <img src="https://img.shields.io/badge/After%20Effects-2024+-9999FF?style=for-the-badge&logo=adobe-after-effects&logoColor=white" alt="After Effects 2024+"/>
  3. <img src="https://img.shields.io/badge/MCP-Protocol-00D4AA?style=for-the-badge" alt="MCP Protocol"/>
  4. <img src="https://img.shields.io/badge/Node.js-18+-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js 18+"/>
  5. <img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="MIT License"/>
  6. </p>
  7. <h1 align="center">AE-MCP</h1>
  8. <p align="center"><strong>After Effects Model Context Protocol Server</strong></p>
  9. <p align="center">Automate Adobe After Effects with AI through 65 MCP tools</p>
  10. ---
  11. ## 关于这个版本 / About this build
  12. 本仓库是 [ishu86/after-effects-mcp](https://github.com/ishu86/after-effects-mcp) 的 Windows 实测分支,
  13. 在 **AE 2024 (24.6.2)** 上跑通全部 65 个工具,并修了一批上游的问题:
  14. - **编码**:`host.jsx` 读写统一 UTF-8,非 ASCII 转义为 `\uXXXX`;`file-communicator` 对响应做一次 URL 解码 → 中文项目名 / 图层名不再乱码
  15. - **`get_layer_info`**:额外返回 effect 名称与参数值,排查特效参数不用再猜
  16. - **`get_keyframes`**:补齐 in/out temporal ease 的 `speed` / `influence`
  17. - **`modify_effect_properties`**:支持直接改 effect 的 `name`(显示名)
  18. - **`get_expression`**:修掉返回对象没被包成表达式体的 bug
  19. - 📘 **给 agent 的连接教程**(安装 / 各家客户端配置 / 探活 / 故障排查):[`AGENT-CONNECT.md`](AGENT-CONNECT.md)
  20. - 📘 **AE 领域知识**(属性路径、预设、常见坑):[`SKILL/SKILL.md`](SKILL/SKILL.md)
  21. ---
  22. ## Overview
  23. 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.
  24. ### Key Features
  25. | Feature | Description |
  26. |---------|-------------|
  27. | **65 Tools** | Complete After Effects automation |
  28. | **Animation Presets** | Spring physics, bounce, elastic, slide, fade |
  29. | **Expression Library** | 20+ pre-built expressions (wiggle, loop, physics) |
  30. | **Effect Templates** | One-click professional looks (cinematic, VHS, neon) |
  31. | **Motion Graphics** | Lower thirds, title cards, transitions, logo reveals |
  32. | **Reliable Architecture** | File-based communication for stability |
  33. ---
  34. ## Requirements
  35. - **Adobe After Effects 2024** or later
  36. - **Node.js 18+**
  37. - **macOS** or **Windows**
  38. ---
  39. ## Installation
  40. ### Step 1: Install the MCP Server
  41. ```bash
  42. git clone https://github.com/Aite25/ae-mcp.git
  43. cd ae-mcp
  44. npm install
  45. npm run build
  46. ```
  47. ### Step 2: Install the CEP Extension
  48. **macOS:**
  49. ```bash
  50. ./scripts/install-cep.sh
  51. ```
  52. **Windows:**
  53. ```batch
  54. scripts\install-cep.bat
  55. ```
  56. ### Step 3: Configure Your AI Assistant
  57. <details>
  58. <summary><strong>Claude Desktop</strong></summary>
  59. Add to your config file:
  60. - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
  61. - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
  62. ```json
  63. {
  64. "mcpServers": {
  65. "ae-mcp": {
  66. "command": "node",
  67. "args": ["/path/to/ae-mcp/dist/index.js"]
  68. }
  69. }
  70. }
  71. ```
  72. </details>
  73. <details>
  74. <summary><strong>Claude Code (CLI)</strong></summary>
  75. Add to your MCP settings (`~/.claude/settings.json`):
  76. ```json
  77. {
  78. "mcpServers": {
  79. "ae-mcp": {
  80. "command": "node",
  81. "args": ["/path/to/ae-mcp/dist/index.js"]
  82. }
  83. }
  84. }
  85. ```
  86. **Bonus:** This repo includes a **Claude Code Skill** for enhanced After Effects automation. Copy the skill files to your Claude Code skills directory:
  87. ```bash
  88. cp -r SKILL/* ~/.claude/skills/
  89. ```
  90. The Claude Code skill provides specialized knowledge about After Effects workflows, property formats, and best practices. See [`SKILL/SKILL.md`](SKILL/SKILL.md) for details.
  91. </details>
  92. ### Step 4: Launch After Effects
  93. 1. Start **After Effects 2024+**
  94. 2. Open **Window > Extensions > AE-MCP**
  95. 3. The panel will auto-start and begin listening for commands
  96. ---
  97. ## Tool Categories
  98. ### Project & Composition
  99. `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`
  100. ### Layer Creation
  101. `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`
  102. ### Animation & Keyframing
  103. `set_keyframe` · `set_keyframe_advanced` · `apply_easy_ease` · `set_temporal_ease` · `offset_keyframes` · `scale_keyframe_timing` · `reverse_keyframes` · `copy_keyframes` · `get_keyframes`
  104. ### Expressions
  105. `set_expression` · `get_expression` · `remove_expression` · `enable_expression` · `add_expression_control` · `apply_expression_template` · `link_properties`
  106. ### Effects
  107. `apply_effect` · `apply_effect_template` · `modify_effect_properties` · `remove_effect` · `reorder_effects` · `copy_effects` · `list_effects`
  108. ### Motion Graphics Templates
  109. | Tool | Styles |
  110. |------|--------|
  111. | `create_lower_third` | modern, corporate, news, minimal, social |
  112. | `create_title_card` | cinematic, documentary, social, minimal |
  113. | `create_transition` | wipe, dissolve, push, slide, zoom |
  114. | `create_logo_reveal` | fade, scale, slide, spin, glitch, particle |
  115. | `create_text_animator` | typewriter, fadeIn, scaleIn, slideIn, randomize, wave |
  116. ### Asset Management
  117. `import_folder` · `replace_footage` · `organize_project_items` · `find_missing_footage` · `collect_files` · `reduce_project`
  118. ### Markers & Timeline
  119. `add_composition_marker` · `add_layer_marker` · `get_markers` · `delete_marker` · `set_work_area`
  120. ---
  121. ## Quick Examples
  122. ### Create an animated intro
  123. ```
  124. Create a 1920x1080 composition called "Intro" at 30fps, 5 seconds.
  125. Add a text layer saying "Welcome" centered on screen.
  126. Apply a slideInUp animation with easy ease.
  127. Add a subtle glow effect.
  128. ```
  129. ### Build a lower third
  130. ```
  131. Create a modern lower third:
  132. - Name: "Sarah Chen"
  133. - Title: "Lead Designer"
  134. - Blue primary color
  135. - Animate in and out
  136. - 5 second duration
  137. ```
  138. ### Add physics-based motion
  139. ```
  140. Add a bounce expression to the position of "Logo" layer.
  141. Set amplitude to 0.15, frequency to 4, decay to 6.
  142. ```
  143. ---
  144. ## Animation Presets
  145. ### Spring Physics (Remotion-inspired)
  146. | Preset | Description |
  147. |--------|-------------|
  148. | `gentle` | Subtle, smooth animations |
  149. | `default` | Balanced spring motion |
  150. | `wobbly` | Playful, bouncy animations |
  151. | `stiff` | Quick, responsive animations |
  152. | `slow` | Heavy, deliberate motion |
  153. | `bouncy` | High energy bounces |
  154. | `snappy` | Instant, responsive feel |
  155. ### Motion Presets
  156. **Fade:** `fadeIn` · `fadeOut`
  157. **Slide:** `slideInLeft` · `slideInRight` · `slideInUp` · `slideInDown` · `slideOutLeft` · `slideOutRight` · `slideOutUp` · `slideOutDown`
  158. **Scale:** `scaleIn` · `scaleOut` · `scaleInBounce`
  159. **Physics:** `bounce` · `elastic` · `overshoot`
  160. **Rotate:** `spinIn` · `spinOut`
  161. ---
  162. ## Expression Templates
  163. | Category | Templates |
  164. |----------|-----------|
  165. | **Wiggle** | `wiggle` · `wiggleSmooth` · `wiggleFadeIn` · `wiggleFadeOut` |
  166. | **Loop** | `loopCycle` · `loopPingpong` · `loopOffset` · `loopContinue` |
  167. | **Physics** | `bounce` · `inertia` · `springy` · `overshoot` |
  168. | **Linking** | `matchPosition` · `offsetPosition` · `followWithDelay` · `inverseRotation` |
  169. | **Time** | `time` · `clock` · `countdown` · `frameNumber` |
  170. ---
  171. ## Effect Templates
  172. | Category | Effects |
  173. |----------|---------|
  174. | **Blur** | `gaussianBlur` · `directionalBlur` · `glassBlur` |
  175. | **Color** | `curves` · `colorBalance` · `brightnessContrast` · `vibrance` |
  176. | **Stylistic** | `glow` · `dropShadow` · `vignette` |
  177. | **Creative** | `cinematicLook` · `vhsRetro` · `neonGlow` · `filmGrain` · `chromaticAberration` · `duotone` |
  178. ---
  179. ## Architecture
  180. ```
  181. ae-mcp/
  182. ├── src/ # TypeScript source
  183. │ ├── index.ts # Entry point
  184. │ ├── stdio-server.ts # MCP server (65 tools)
  185. │ ├── ae-integration/
  186. │ │ ├── file-communicator.ts # File-based IPC
  187. │ │ └── generators/ # ES3 script generators
  188. │ └── presets/ # Animation, expression, effect presets
  189. ├── cep-extension/ # After Effects extension
  190. │ ├── CSXS/manifest.xml
  191. │ ├── jsx/host.jsx # ExtendScript host
  192. │ └── js/main.js # Panel JavaScript
  193. ├── SKILL/ # Claude Code skill
  194. │ ├── SKILL.md # Skill definition
  195. │ └── examples.md # Animation examples
  196. └── scripts/ # Installation scripts
  197. ```
  198. ### Communication Flow
  199. ```
  200. AI Assistant (Claude)
  201. ↓
  202. MCP Server (Node.js)
  203. ↓ Write JSON command
  204. ~/Documents/ae-mcp-commands/
  205. ↓ Poll every 100ms
  206. CEP Extension
  207. ↓ Execute script
  208. After Effects DOM
  209. ↓ Write response
  210. *.json.response
  211. ```
  212. ---
  213. ## Troubleshooting
  214. <details>
  215. <summary><strong>Extension not appearing in After Effects</strong></summary>
  216. 1. Verify debug mode is enabled (the install script does this automatically)
  217. 2. Restart After Effects completely
  218. 3. Check extension location:
  219. - **macOS:** `~/Library/Application Support/Adobe/CEP/extensions/ae-mcp`
  220. - **Windows:** `%APPDATA%\Adobe\CEP\extensions\ae-mcp`
  221. </details>
  222. <details>
  223. <summary><strong>Commands timing out</strong></summary>
  224. 1. Ensure the AE-MCP panel is **visible** in After Effects
  225. 2. Check `~/Documents/ae-mcp-commands/` for command files
  226. 3. Look at the panel's log for errors
  227. </details>
  228. <details>
  229. <summary><strong>Script errors</strong></summary>
  230. 1. Open the ExtendScript Toolkit or console in After Effects
  231. 2. Verify composition/layer references exist
  232. 3. Check for ES3 compatibility issues (no arrow functions, template literals, etc.)
  233. </details>
  234. ---
  235. ## Contributing
  236. Contributions are welcome! Please read our contributing guidelines before submitting PRs.
  237. ## License
  238. MIT
  239. ---
  240. <p align="center">
  241. <sub>Built for motion designers who want to work faster with AI</sub>
  242. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.