AE-MCP

개요

AE-MCP는 Claude와 같은 AI 어시스턴트가 Adobe After Effects를 직접 제어할 수 있게 해주는 종합적인 MCP 서버입니다. 70개 이상의 도구를 제공하여 컴포지션 생성부터 전문적인 효과 및 표현식 적용까지 모션 그래픽 워크플로우 전체를 포괄합니다.

주요 기능

Related MCP server: AE MCP Server

요구 사항

• Adobe After Effects 2024 이상

• Node.js 18+

• macOS 또는 Windows

설치

1단계: MCP 서버 설치

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

2단계: CEP 확장 설치

macOS:

./scripts/install-cep.sh

Windows:

scripts\install-cep.bat

3단계: 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"]
    }
  }
}

보너스: 이 저장소에는 향상된 After Effects 자동화를 위한 Claude Code Skill이 포함되어 있습니다. 스킬 파일을 Claude Code 스킬 디렉토리에 복사하세요:

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

Claude Code 스킬은 After Effects 워크플로우, 속성 형식 및 모범 사례에 대한 전문 지식을 제공합니다. 자세한 내용은 SKILL/SKILL.md를 참조하세요.

4단계: After Effects 실행

1. **After Effects 2024+**를 시작합니다.

2. Window > Extensions > 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 기반)

모션 프리셋

Fade: fadeIn · fadeOut Slide: slideInLeft · slideInRight · slideInUp · slideInDown · slideOutLeft · slideOutRight · slideOutUp · slideOutDown Scale: scaleIn · scaleOut · scaleInBounce Physics: bounce · elastic · overshoot Rotate: 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. After Effects에서 AE-MCP 패널이 보이는지 확인하세요

2. ~/Documents/ae-mcp-commands/에서 명령 파일을 확인하세요

3. 패널 로그에서 오류를 확인하세요

1. After Effects에서 ExtendScript Toolkit 또는 콘솔을 여세요

2. 컴포지션/레이어 참조가 존재하는지 확인하세요

3. ES3 호환성 문제가 있는지 확인하세요 (화살표 함수, 템플릿 리터럴 등 미사용)

기여

기여를 환영합니다! PR을 제출하기 전에 기여 가이드라인을 읽어주세요.

라이선스

MIT