After Effects MCP Custom
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@After Effects MCP Custom Create a new composition called 'MyComp' and add a text layer with 'Hello'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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에서 다음을 설정합니다.
Settings/Preferences > Scripting & Expressions를 엽니다.Allow Scripts to Write Files and Access Network를 활성화합니다.After Effects를 재시작합니다.
Window > mcp-bridge-auto.jsx를 엽니다.패널의
Auto-run commands를 활성화합니다.
MCP 클라이언트별 설정과 수동 설치 경로는 전체 설치 가이드를 참고하세요.
주요 기능
영역 | 현재 기능 |
프로젝트·컴포지션 | 프로젝트 정보 조회, 컴포지션 조회·생성·속성 변경 |
레이어 생성 | 텍스트, 쉐이프, 솔리드·조정 레이어, 카메라 |
레이어 편집 | 위치·크기·회전·불투명도·타이밍·3D·블렌드·트랙 매트, 복제·삭제 |
애니메이션 | 키프레임 설정, Expression 설정·제거, 여러 레이어 일괄 속성 변경 |
마스크 | 마스크 생성·수정, feather·expansion·opacity 설정 |
이펙트 | 이름 또는 match name으로 적용, |
MCP 보조 기능 | 도움말, 결과 조회, 컴포지션 리소스, 브리지 테스트 |
MCP 도구
직접 노출되는 주요 도구는 다음과 같습니다.
run-scriptget-resultsget-helpcreate-compositionsetLayerKeyframesetLayerExpressionapply-effectapply-effect-templatemcp_aftereffects_applyEffectmcp_aftereffects_applyEffectTemplatemcp_aftereffects_get_effects_helprun-bridge-testtest-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 toolsapply-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
Scored across 13 tools
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 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.
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.
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
Related MCP Connectors
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for Hailuo (MiniMax) AI video generation
Remote MCP server for AI.TV creators — delegate account operations to your AI agent over MCP.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that enables AI assistants to control Adobe After Effects through a file-based communication bridge. It supports various operations including project and composition management, layer and keyframe manipulation, rendering, and batch processing.9227 npm21MIT
- AlicenseAqualityDmaintenanceAn MCP server that allows AI agents to control Adobe After Effects, enabling project inspection, composition creation, layer addition, file import, ExtendScript execution, and rendering via aerender.11MIT
- AlicenseCqualityDmaintenanceMCP server for controlling Adobe After Effects, enabling AI assistants to create compositions, manage layers, and animate properties.13MIT
- AlicenseBqualityDmaintenanceMCP server that lets AI assistants control Adobe After Effects via natural language, enabling composition and layer creation, animation, effects, presets, rendering, and arbitrary ExtendScript execution with Arabic/RTL support.50182 npmMIT