AE-MCP

概述

AE-MCP 是一个全面的 MCP 服务器，使 Claude 等 AI 助手能够直接控制 Adobe After Effects。它提供 70+ 个工具，覆盖完整的运动图形工作流程——从创建合成到应用专业效果和表达式。

主要功能

Related MCP server: After Effects MCP Server

系统要求

• Adobe After Effects 2024 或更高版本

• Node.js 18+

• macOS 或 Windows

安装

第一步：安装 MCP 服务器

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

第二步：安装 CEP 扩展

macOS:

./scripts/install-cep.sh

Windows:

scripts\install-cep.bat

第三步：配置您的 AI 助手

添加到您的配置文件中：

• 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"]
    }
  }
}

添加到您的 MCP 设置 (~/.claude/settings.json)：

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

额外福利： 此仓库包含一个 Claude Code 技能，用于增强 After Effects 自动化。将技能文件复制到您的 Claude Code 技能目录：

cp -r SKILL/* ~/.claude/skills/

Claude Code 技能提供关于 After Effects 工作流程、属性格式和最佳实践的专业知识。详情请参阅 SKILL/SKILL.md。

第四步：启动 After Effects

1. 启动 After Effects 2024+

2. 打开 窗口 > 扩展 > AE-MCP

3. 面板将自动启动并开始监听命令

工具分类

项目与合成

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

图层创建

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

动画与关键帧

set_keyframe · set_keyframe_advanced · apply_easy_ease · set_temporal_ease · offset_keyframes · scale_keyframe_timing · reverse_keyframes · copy_keyframes · get_keyframes

表达式

set_expression · get_expression · remove_expression · enable_expression · add_expression_control · apply_expression_template · link_properties

效果

apply_effect · apply_effect_template · modify_effect_properties · remove_effect · reorder_effects · copy_effects · list_effects

运动图形模板

资产管理

import_folder · replace_footage · organize_project_items · find_missing_footage · collect_files · reduce_project

标记与时间轴

add_composition_marker · add_layer_marker · get_markers · delete_marker · set_work_area

快速示例

创建动画片头

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.

构建下三分之一

Create a modern lower third:
- Name: "Sarah Chen"
- Title: "Lead Designer"
- Blue primary color
- Animate in and out
- 5 second duration

添加基于物理的运动

Add a bounce expression to the position of "Logo" layer.
Set amplitude to 0.15, frequency to 4, decay to 6.

动画预设

弹簧物理（灵感来自 Remotion）

运动预设

淡入淡出： fadeIn · fadeOut 滑动： slideInLeft · slideInRight · slideInUp · slideInDown · slideOutLeft · slideOutRight · slideOutUp · slideOutDown 缩放： scaleIn · scaleOut · scaleInBounce 物理： bounce · elastic · overshoot 旋转： spinIn · spinOut

表达式模板

效果模板

架构

ae-mcp/
├── src/                          # TypeScript source
│   ├── index.ts                  # Entry point
│   ├── stdio-server.ts           # MCP server (70+ 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 scripts

通信流程

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.response

故障排除

1. 确认调试模式已启用（安装脚本会自动执行此操作）

2. 完全重启 After Effects

3. 检查扩展位置：

   • macOS: ~/Library/Application Support/Adobe/CEP/extensions/ae-mcp

   • Windows: %APPDATA%\Adobe\CEP\extensions\ae-mcp

1. 确保 AE-MCP 面板在 After Effects 中可见

2. 检查 ~/Documents/ae-mcp-commands/ 中的命令文件

3. 查看面板日志中的错误

1. 打开 After Effects 中的 ExtendScript 工具包或控制台

2. 确认合成/图层引用存在

3. 检查 ES3 兼容性问题（无箭头函数、模板字符串等）

贡献

欢迎贡献！在提交 PR 之前，请阅读我们的贡献指南。

许可证

MIT