after-effects-mcp MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

14+ 툴: 컴포지션, 레이어, 카메라, 널, 키프레임, 표현식, 마스크
ExtendScript 브리지 패널이 명령을 폴링 — AE 프로세스에서 실행
.mcp.json으로 Claude Code에서 동작; 다른 클라이언트는 수동 설정
블렌드 모드, 3D 레이어, 트랙 매트, 마스크 페더/확장 지원
batchSetLayerProperties로 일괄 속성 업데이트

라이브 데모

실제 사용 모습

after-effects.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "after-effects",
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "after-effects": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "after-effects-mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add after-effects -- npx -y after-effects-mcp

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: after-effects-mcp

CSV로부터 템플릿 기반 로워 서드 생성

👤 에피소드마다 10개 이상의 로워 서드를 만드는 모션 그래픽 아티스트 ⏱ ~20 min intermediate

언제 쓸까: 이름/직함이 있는 CSV가 있고 각각을 컴포지션에 직접 타이핑하고 싶지 않을 때.

사전 조건

브리지 패널이 설치된 After Effects 2022+ — npm run install-bridge 후 mcp-bridge-auto.jsx를 열고 'Auto-run commands' 체크
.mcp.json으로 MCP 추가 — build/index.js를 지정하고 클라이언트 재시작

흐름

기본 컴포지션 생성

'LT_01' 컴포지션 1920x1080 29.97 5s 검정 배경으로 만들어줘.✓ 복사됨

→ AE에 컴포지션 표시
이름 + 직함 텍스트 레이어 추가

'Dr. Jane Doe' 텍스트 레이어를 좌하단 (120, 900) 72pt로 추가. '리드 사이언티스트'는 (120, 960) 36pt로 아래 추가.✓ 복사됨

→ 레이어가 보임
키프레임으로 in/out 애니메이션 추가

위치 키프레임 설정: 두 텍스트 레이어 모두 0-15 프레임 사이에 x=-400에서 슬라이드 인, 120-135 프레임에서 슬라이드 아웃.✓ 복사됨

→ 애니메이션 로워 서드

결과: CSV의 각 행에 맞춰 복제/편집할 수 있는 로워 서드 템플릿.

함정

브리지 패널의 'Auto-run' 미체크 — 명령이 영원히 대기 — AE를 재실행할 때마다 패널을 열어 체크박스를 확인하세요
한 번에 너무 많은 명령을 보내면 AE UI 정지 — 100개의 개별 호출 대신 batchSetLayerProperties로 묶으세요

함께 쓰기: filesystem

표현식 기반 데이터 시각화 구축

👤 인포그래픽을 만드는 모션 디자이너 ⏱ ~20 min advanced

언제 쓸까: 데이터 배열로부터 애니메이션되는 셰이프가 필요하고 각각 키프레임하고 싶지 않을 때.

흐름

기본 셰이프 생성

'bar_01' 셰이프 레이어 생성 — 사각형, 중심 앵커, (200,900)에 80x0.✓ 복사됨

→ 높이 0의 셰이프
표현식 연결

bar_01 Scale.y에 30 프레임 동안 0에서 [value]까지 이징으로 증가하는 표현식을 설정해줘.✓ 복사됨

→ 표현식이 적용되고 정상 재생

결과: 루프로 데이터 포인트마다 복제할 수 있는 셰이프 + 표현식 하나.

기본 레이어를 복제하고 복사본마다 속성 수정

👤 N개 아이템에 걸쳐 디자인을 복제하는 누구나 ⏱ ~10 min beginner

언제 쓸까: 스타일 지정된 로고 하나가 있고 원 주위에 배치된 12개 변형이 필요할 때.

흐름

N번 복제

'logo_base' 레이어를 12번 복제하고 logo_00부터 logo_11까지 이름 지정.✓ 복사됨

→ 레이어 12개 존재
각각 배치

각 logo_NN을 (960,540) 주위 반지름 400px 원 위의 점에 배치, 각도 = NN * 30도.✓ 복사됨

→ 로고의 원형 배치

결과: 수 초 만에 깔끔하게 배열된 그룹.

조합

다른 MCP와 조합해 10배 효율

after-effects + davinci-resolve

AE에서 모션 그래픽 제작, Resolve에서 편집 마무리

After Effects에서 6초 타이틀 카드 만들어 ~/renders/title.mov로 렌더링한 뒤, 활성 Resolve 타임라인 앞에 임포트해줘.✓ 복사됨

after-effects + filesystem

디스크의 데이터 파일로부터 AE 컴포지션 생성

./data/speakers.csv를 읽어줘. 각 행에 대해 해당 연사의 이름과 직함으로 AE에 로워 서드 컴포지션을 만들어줘.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
create-composition	name, width, height, duration, frameRate	새 컴포지션	free (local AE)
run-script	script: ExtendScript	명명된 툴로 커버되지 않는 경우의 탈출구	free
get-results	command_id: str	브리지로부터 비동기 결과 가져오기	free
setLayerKeyframe	layer, property, time, value	키프레임 추가	free
setLayerExpression	layer, property, expression: str	속성에 표현식 바인딩	free
setLayerProperties	layer, properties: object	트랜스폼, 불투명도, 블렌드 모드 업데이트	free
batchSetLayerProperties	updates: [{layer, properties}]	N번의 왕복 호출 방지	free
getLayerInfo	layer	수정 전 확인	free
createCamera	name, options?	3D 워크플로	free
createNullObject	name	리깅을 위한 부모 대상	free
duplicateLayer	layer	복제	free
deleteLayer	layer	정리	free
setLayerMask	layer, maskShape, feather?, expansion?	마스크 추가/수정	free

비용 및 제한

운영 비용

API 쿼터: 없음 — 로컬 AE 자동화
호출당 토큰: 명령 문자열과 확인 응답 모두 아주 작음
금액: Adobe After Effects 라이선스 필요; MCP 자체는 무료
팁: 큰 씬에서 왕복 호출을 줄이려면 batchSetLayerProperties를 쓰세요.

보안

권한, 시크릿, 파급범위

자격 증명 저장: 없음

데이터 외부 송신: 없음 — 로컬 브리지만 사용

절대 부여 금지:

신뢰할 수 없는 프롬프트에서 임의의 ExtendScript 실행 — `run-script`는 AE가 할 수 있는 것은 뭐든 실행

브리지 패널이 명령을 자동 실행합니다 — MCP 세션이 아닐 때는 AE를 닫거나 체크박스를 해제하세요.
run-script를 eval로 취급하세요: 그걸 생성하는 프롬프트를 검토하세요.

문제 해결

자주 발생하는 오류와 해결

Commands queue but never execute

브리지 패널에서 'Auto-run commands' 체크 해제 상태. 체크하세요.

확인: mcp-bridge-auto.jsx 패널 확인

Module import error on MCP start

Node 14+ 필요; MCP 저장소에서 npm install로 의존성 설치.

확인: node --version

AE hangs during batch operations

개별 호출이 너무 많음; batchSetLayerProperties로 전환.

Expressions error 'value is undefined'

표현식이 존재하지 않는 레이어/속성을 참조. setLayerExpression 인자의 철자를 다시 확인.

확인: AE의 표현식 오류 오버레이 열기

대안

after-effects-mcp 다른 것과 비교

대안	언제 쓰나	단점/장점
DaVinci Resolve MCP	모션 그래픽이 아닌 편집/컬러 작업 중일 때	파이프라인의 단계가 다름
Manual ExtendScript via .jsx files	AI 없이 완전한 제어를 원할 때	채팅 인터페이스 없음

after-effects-mcp