🎬 애프터 이펙트 MCP 서버
✨ AI 어시스턴트와 기타 애플리케이션이 표준화된 프로토콜을 통해 After Effects를 제어할 수 있도록 하는 Adobe After Effects용 MCP(Model Context Protocol) 서버입니다.
목차
Related MCP server: ABAP-ADT-API MCP-Server
📦 특징
🎥 핵심 구성 기능
사용자 정의 설정(크기, 프레임 속도, 지속 시간, 배경색)으로 구성 만들기
프로젝트의 모든 작곡을 나열하세요
프레임 속도, 크기, 기간 등의 프로젝트 정보를 얻으세요
🧱 레이어 관리
사용자 정의 가능한 속성(글꼴, 크기, 색상, 위치)을 사용하여 텍스트 레이어를 만듭니다.
색상과 선을 사용하여 모양 레이어(사각형, 타원, 다각형, 별)를 만듭니다.
배경 및 효과에 대한 단색/조정 레이어 만들기
위치, 크기, 회전, 불투명도, 타이밍과 같은 레이어 속성을 수정합니다.
🌀 애니메이션 기능
레이어 속성(위치, 크기, 회전, 불투명도 등)에 대한 키프레임을 설정합니다 .
동적 애니메이션을 위해 레이어 속성에 표현식 적용
⚙️ 설정 지침
🛠 필수 조건
Adobe After Effects(2022 이상)
Node.js(v14 이상)
npm 또는 yarn 패키지 관리자
📥 설치
저장소를 복제합니다
지엑스피1
종속성 설치
npm install # or yarn install프로젝트를 빌드하세요
npm run build # or yarn buildAfter Effects 패널 설치
npm run install-bridge # or yarn install-bridge이렇게 하면 필요한 스크립트가 After Effects 설치에 복사됩니다.
🔧 MCP 구성 업데이트
클라이언트(예: Claude 또는 Cursor)로 이동하여 구성 파일을 업데이트하세요.
▶️ 서버 실행
MCP 서버를 시작합니다
npm start # or yarn start애프터 이펙트 열기
MCP Bridge Auto 패널을 엽니다.
After Effects에서 Window > mcp-bridge-auto.jsx로 이동합니다.
패널은 몇 초마다 자동으로 명령을 확인합니다.
"자동 실행 명령" 체크박스가 활성화되어 있는지 확인하세요.
🚀 사용 가이드
서버를 실행하고 After Effects에서 MCP Bridge 패널을 열면 MCP 프로토콜을 통해 After Effects를 제어할 수 있습니다. 이를 통해 AI 어시스턴트나 사용자 지정 애플리케이션에서 After Effects에 명령을 전송할 수 있습니다.
📘 작곡 만들기
사용자 정의 설정으로 새로운 작곡을 만들 수 있습니다.
이름
너비와 높이(픽셀)
프레임 속도
지속
배경색
MCP 도구 사용 예시(개발자용):
✍️ 레이어 작업
다양한 유형의 레이어를 만들고 수정할 수 있습니다.
텍스트 레이어:
텍스트 내용, 글꼴, 크기 및 색상 설정
구성의 어느 곳에나 텍스트를 배치합니다.
타이밍과 불투명도 조정
모양 레이어:
사각형, 타원, 다각형, 별을 만듭니다.
채우기 및 획 색상 설정
크기와 위치 사용자 정의
고체 층:
배경색 만들기
효과에 대한 조정 레이어 만들기
🕹 애니메이션
다음을 사용하여 레이어에 애니메이션을 적용할 수 있습니다.
키프레임:
특정 시간에 속성 값 설정
동작, 크기 조정, 회전 및 불투명도 변경을 만듭니다.
애니메이션의 타이밍을 제어합니다
표현:
속성에 JavaScript 표현식 적용
동적이고 절차적인 애니메이션을 만듭니다.
속성 값을 서로 연결하세요
🛠 사용 가능한 MCP 도구
명령 | 설명 |
`create-composition` | 새로운 경쟁을 만드세요 |
`실행 스크립트` | AE 내부에서 JS 스크립트 실행 |
`get-results` | 스크립트 결과 가져오기 |
`도움말 받기` | 사용 가능한 명령에 대한 도움말 |
`setLayerKeyframe` | 레이어 속성에 키프레임 추가 |
`setLayerExpression` | 속성에서 표현식 추가/제거 |
👨💻 개발자를 위한
🧩 프로젝트 구조
src/index.ts: MCP 서버 구현src/scripts/mcp-bridge-auto.jsx: After Effects 메인 패널 스크립트install-bridge.js: After Effects에 패널을 설치하는 스크립트
📦 프로젝트 구축
🤝 기여하기
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.