mcp-애프터 이펙트

🎬 애프터 이펙트 MCP 서버

✨ AI 어시스턴트와 기타 애플리케이션이 표준화된 프로토콜을 통해 After Effects를 제어할 수 있도록 하는 Adobe After Effects용 MCP(Model Context Protocol) 서버입니다.

📦 특징

🎥 핵심 구성 기능

사용자 정의 설정(크기, 프레임 속도, 지속 시간, 배경색)으로 구성 만들기
프로젝트의 모든 작곡을 나열하세요
프레임 속도, 크기, 기간 등의 프로젝트 정보를 얻으세요

🧱 레이어 관리

사용자 정의 가능한 속성(글꼴, 크기, 색상, 위치)을 사용하여 텍스트 레이어를 만듭니다.
색상과 선을 사용하여 모양 레이어(사각형, 타원, 다각형, 별)를 만듭니다.
배경 및 효과에 대한 단색/조정 레이어 만들기
위치, 크기, 회전, 불투명도, 타이밍과 같은 레이어 속성을 수정합니다.

🌀 애니메이션 기능

레이어 속성(위치, 크기, 회전, 불투명도 등)에 대한 키프레임을 설정합니다 .
동적 애니메이션을 위해 레이어 속성에 표현식 적용

⚙️ 설정 지침

🛠 필수 조건

Adobe After Effects(2022 이상)
Node.js(v14 이상)
npm 또는 yarn 패키지 관리자

📥 설치

저장소를 복제합니다지엑스피1
종속성 설치
npm install # or yarn install
프로젝트를 빌드하세요
npm run build # or yarn build
After Effects 패널 설치
npm run install-bridge # or yarn install-bridge
이렇게 하면 필요한 스크립트가 After Effects 설치에 복사됩니다.

🔧 MCP 구성 업데이트

클라이언트(예: Claude 또는 Cursor)로 이동하여 구성 파일을 업데이트하세요.

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
    }
  }
}

▶️ 서버 실행

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 도구 사용 예시(개발자용):

mcp_aftereffects_create_composition({
  name: "My Composition", 
  width: 1920, 
  height: 1080, 
  frameRate: 30,
  duration: 10
});

✍️ 레이어 작업

다양한 유형의 레이어를 만들고 수정할 수 있습니다.

텍스트 레이어:

텍스트 내용, 글꼴, 크기 및 색상 설정
구성의 어느 곳에나 텍스트를 배치합니다.
타이밍과 불투명도 조정

모양 레이어:

사각형, 타원, 다각형, 별을 만듭니다.
채우기 및 획 색상 설정
크기와 위치 사용자 정의

고체 층:

배경색 만들기
효과에 대한 조정 레이어 만들기

🕹 애니메이션

다음을 사용하여 레이어에 애니메이션을 적용할 수 있습니다.

키프레임:

특정 시간에 속성 값 설정
동작, 크기 조정, 회전 및 불투명도 변경을 만듭니다.
애니메이션의 타이밍을 제어합니다

표현:

속성에 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에 패널을 설치하는 스크립트

📦 프로젝트 구축

npm run build
# or
yarn build

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

mcp-after-effects

Integrations