Comfy AE Video Factory MCP

AI 숏폼 비디오 자동화 파이프라인을 위한 MCP 서버: ComfyUI 이미지-투-이미지/이미지-투-비디오, FFmpeg 후처리, After Effects 템플릿 패키징, 검토 및 멀티 플랫폼 게시 준비 과정을 연결합니다.

설계 목표: Cursor / Claude Desktop / ChatGPT MCP 클라이언트가 이러한 도구를 호출하여 「생성 → 패키징 → 검토 → 내보내기 → 게시 패키지」 프로세스를 자동으로 완료할 수 있도록 합니다.

기능

• 로컬 또는 클라우드 ComfyUI 워크플로우 호출

• ComfyUI 작업 기록 조회

• FFprobe를 사용한 비디오 분석

• FFmpeg를 사용한 트랜스코딩, 크롭, 프레임 추출, 병합

• AE 자동 소재 교체 JSX 스크립트 생성

• aerender를 호출하여 After Effects 템플릿 렌더링

• 표준화된 비디오 제작 작업 manifest 생성

• Douyin / Xiaohongshu / Bilibili / YouTube Shorts / TikTok 게시 패키지 구성 생성

• 향후 타사 검토 API 연동을 위한 기본 콘텐츠 검토 플레이스홀더 인터페이스 제공

설치

npm install
npm run build

실행

npm start

MCP 클라이언트 설정

{
  "mcpServers": {
    "comfy-ae-video-factory": {
      "command": "node",
      "args": ["/absolute/path/comfy-ae-video-factory-mcp/dist/index.js"],
      "env": {
        "COMFY_LOCAL_URL": "http://127.0.0.1:8188",
        "VIDEO_FACTORY_ROOT": "/absolute/path/workspace",
        "FFMPEG_BIN": "ffmpeg",
        "FFPROBE_BIN": "ffprobe",
        "AERENDER_BIN": "/Applications/Adobe After Effects 2025/aerender"
      }
    }
  }
}

Windows 예시:

{
  "AERENDER_BIN": "C:\\Program Files\\Adobe\\Adobe After Effects 2025\\Support Files\\aerender.exe"
}

권장 워크플로우

1. pipeline_create_job으로 제작 작업 디렉토리 및 manifest 생성

2. comfy_submit_workflow로 ComfyUI 이미지-투-비디오 워크플로우 제출

3. comfy_get_history로 결과 조회

4. media_probe로 비디오 사양 확인

5. ffmpeg_transcode로 비율, 비트레이트, 프레임 레이트 통일

6. ae_generate_jsx로 AE 템플릿 교체 스크립트 생성

7. ae_render_template로 aerender를 호출하여 최종 패키징 비디오 출력

8. review_video_package로 검토 플레이스홀더 수행

9. platform_prepare_package로 각 플랫폼 게시 패키지 생성

AE 템플릿 연동 방식

AE 프로젝트 내에 다음과 같은 플레이스홀더 레이어를 미리 생성하는 것을 권장합니다:

• {{MAIN_VIDEO}}

• {{TITLE}}

• {{SUBTITLE}}

• {{LOGO}}

• {{CTA}}

그런 다음 본 프로젝트에서 생성된 JSX를 사용하여 소재와 텍스트를 교체하고, aerender를 통해 출력합니다.

보안 참고 사항

이 MCP 서버는 로컬 명령을 실행하므로 기본적으로 다음과 같은 제한이 있습니다:

• 모든 입출력 파일은 VIDEO_FACTORY_ROOT 디렉토리 내에 있어야 합니다.

• FFmpeg 매개변수는 화이트리스트 방식으로 캡슐화되어 있으며, 임의의 셸 명령을 직접 노출하지 않습니다.

• AE 렌더링은 dryRun을 지원하므로 명령을 먼저 테스트하는 것을 권장합니다.

GitHub 업로드

git init
git add .
git commit -m "init comfy ae video factory mcp"
git branch -M main
git remote add origin git@github.com:YOUR_NAME/comfy-ae-video-factory-mcp.git
git push -u origin main

비고

MCP 공식 TypeScript SDK는 서버 생성, 도구 등록을 지원하며 stdio 또는 Streamable HTTP를 통해 MCP 클라이언트에 연결합니다. 여기서는 로컬 자동화 통합에 적합한 stdio를 사용합니다.