Skip to main content
Glama

After Effects MCP Custom

Adobe After Effects를 Codex, Claude, Cursor 같은 MCP 클라이언트에서 제어하기 위한 로컬 MCP 서버입니다. Dakkshin/after-effects-mcp를 기반으로 하며, 현재 설치본을 다른 컴퓨터에서도 재현할 수 있도록 Codex 연결 방식과 한국어 설치·운영 문서를 정리한 커스텀 저장소입니다.

현재 커스텀 범위는 설치·연결·운영 문서, 배포 설정, After Effects ScriptUI 패널 호환성 수정입니다. 다른 After Effects MCP의 추가 기능은 아직 소스에 병합하지 않았습니다. 실제 반영 내역과 다음 후보는 커스텀 내역에 구분해 기록합니다.

지원 환경

  • Adobe After Effects 2022~2026

  • macOS 또는 Windows

  • Node.js 18 이상과 npm

  • 로컬 STDIO MCP를 지원하는 클라이언트

Related MCP server: After Effects MCP

빠른 설치

git clone https://github.com/tkstjd82-cloud/aftereffect_mcp_custom.git
cd aftereffect_mcp_custom
npm install
npm run build
npm run install-bridge

그다음 After Effects에서 다음을 설정합니다.

  1. Settings/Preferences > Scripting & Expressions를 엽니다.

  2. Allow Scripts to Write Files and Access Network를 활성화합니다.

  3. After Effects를 재시작합니다.

  4. Window > mcp-bridge-auto.jsx를 엽니다.

  5. 패널의 Auto-run commands를 활성화합니다.

MCP 클라이언트별 설정과 수동 설치 경로는 전체 설치 가이드를 참고하세요.

주요 기능

영역

현재 기능

프로젝트·컴포지션

프로젝트 정보 조회, 컴포지션 조회·생성·속성 변경

레이어 생성

텍스트, 쉐이프, 솔리드·조정 레이어, 카메라

레이어 편집

위치·크기·회전·불투명도·타이밍·3D·블렌드·트랙 매트, 복제·삭제

애니메이션

키프레임 설정, Expression 설정·제거, 여러 레이어 일괄 속성 변경

마스크

마스크 생성·수정, feather·expansion·opacity 설정

이펙트

이름 또는 match name으로 적용, .ffx 프리셋 적용, 기본 효과 템플릿

MCP 보조 기능

도움말, 결과 조회, 컴포지션 리소스, 브리지 테스트

MCP 도구

직접 노출되는 주요 도구는 다음과 같습니다.

  • run-script

  • get-results

  • get-help

  • create-composition

  • setLayerKeyframe

  • setLayerExpression

  • apply-effect

  • apply-effect-template

  • mcp_aftereffects_applyEffect

  • mcp_aftereffects_applyEffectTemplate

  • mcp_aftereffects_get_effects_help

  • run-bridge-test

  • test-animation

run-script를 통해 getProjectInfo, listCompositions, getLayerInfo, 레이어 생성·수정·복제·삭제, 마스크와 배치 작업 같은 브리지 명령도 호출할 수 있습니다.

동작 구조

Codex / Claude / Cursor
        │ STDIO MCP
        ▼
build/index.js
        │ JSON 명령·결과 파일
        ▼
~/Documents/ae-mcp-bridge/
        │ 주기적 폴링
        ▼
mcp-bridge-auto.jsx 패널
        │ ExtendScript
        ▼
Adobe After Effects

브리지는 다음 두 파일을 사용합니다.

~/Documents/ae-mcp-bridge/ae_command.json
~/Documents/ae-mcp-bridge/ae_mcp_result.json

문서

개발 및 검증

npm ci
npm test
npm run build
npx tsc --noEmit

빌드 결과는 Git에서 제외되며 아래 파일이 생성됩니다.

build/index.js
build/scripts/mcp-bridge-auto.jsx

현재 제약

  • After Effects에서 브리지 패널이 열려 있어야 합니다.

  • 단일 명령·단일 결과 파일을 사용하는 구조라 동시 명령 처리에는 적합하지 않습니다.

  • 미디어 가져오기·교체, 고급 키프레임 이징, 마커·오디오 분석, 렌더 큐 자동화, 프레임 프리뷰는 아직 구현되지 않았습니다.

  • test-animation은 테스트 JSX를 생성하고 사용자가 After Effects에서 직접 실행하는 보조 도구입니다.

라이선스와 출처

MIT License. 원본 프로젝트는 Dakkshin/after-effects-mcp이며, 원본 저작권과 라이선스 고지를 유지합니다.

Available Tools

13 tools
apply-effectC

Apply an effect to a layer in After Effects

Inputs: compIndex (required), layerIndex (required), effectName, presetPath, +3 more.

apply-effect-templateB

Apply a predefined effect template to a layer in After Effects

Inputs: compIndex (required), layerIndex (required), templateName (required), customSettings.

create-compositionA

Create a new composition in After Effects with specified parameters

Inputs: name (required), width (required), height (required), duration, +3 more.

get-helpA

Get help on using the After Effects MCP integration

Inputs: no named parameters.

get-resultsB

Get results from the last script executed in After Effects

Inputs: no named parameters.

mcp_aftereffects_applyEffectC

Apply an effect to a layer in After Effects

Inputs: compIndex (required), layerIndex (required), effectName, effectSettings, +1 more.

mcp_aftereffects_applyEffectTemplateC

Apply a predefined effect template to a layer in After Effects

Inputs: compIndex (required), layerIndex (required), templateName (required), customSettings.

mcp_aftereffects_get_effects_helpB

Get help on using After Effects effects

Inputs: no named parameters.

run-bridge-testA

Run the bridge test effects script to verify communication and apply test effects

Inputs: no named parameters.

run-scriptA

Run a read-only script in After Effects

Inputs: script (required), parameters.

setLayerExpressionB

Set or remove an expression for a specific layer property.

Inputs: compIndex (required), layerIndex (required), propertyName (required), expressionString (required).

setLayerKeyframeB

Set a keyframe for a specific layer property at a given time.

Inputs: compIndex (required), layerIndex (required), propertyName (required), timeInSeconds (required), +1 more.

test-animationD

Test animation functionality in After Effects

Inputs: compIndex (required), operation (required), layerIndex (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.5/5.0

    Scored across 13 tools

    Disambiguation2/5

    There are clear duplicates: apply-effect/mcp_aftereffects_applyEffect and apply-effect-template/mcp_aftereffects_applyEffectTemplate do the same thing. Also get-help vs mcp_aftereffects_get_effects_help overlap in purpose, making it hard for an agent to choose correctly.

    Naming Consistency1/5

    Naming is highly inconsistent: some tools use kebab-case (apply-effect), some camelCase (setLayerExpression), and some have a long prefix 'mcp_aftereffects_' followed by mixed styles (mcp_aftereffects_applyEffect). No predictable pattern.

    Tool Count3/5

    13 tools is reasonable for an After Effects MCP server, but the presence of 4 redundant tools (duplicates and overlapping help) inflates the count without adding value. Could be consolidated to about 9-10 tools.

    Completeness3/5

    Covers creation, effect application, keyframes, expressions, and script execution. However, missing basic operations like composition deletion, modification, import, or rendering. Some gaps exist but core animation tasks are possible.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers