remotion-mcp-server

Claude가 Remotion(React 기반 프로그래매틱 비디오)을 사용하여 참조 동영상을 분석하고 브랜드 Instagram Reels / YouTube Shorts를 생성할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다 — 전적으로 채팅 대화만으로 말이죠.

Claude에게 참조 릴을 지정하면 다음을 수행할 수 있습니다:

1. 다운로드(yt-dlp)하고, 프레임 + 오디오를 추출하며, 전체 트랜스크립트를 얻습니다(YouTube 자막 우선, 그 외 모든 것 — Instagram, TikTok, 로컬 파일 — 은 faster-whisper 폴백 사용).

2. 같은 스타일의 새 컴포지션 — 대화 말풍선 릴 또는 팩트/리스트형 릴 — 을 실제 React/TSX 코드로 생성합니다.

3. Remotion으로 MP4로 렌더링합니다.

4. 최종본으로 확정하기 전에 Remotion Studio에서 열어 프레임 단위로 검토하는 방법을 알려줍니다.

CapCut도, 수동 편집도 필요 없습니다 — Claude가 동영상을 작성합니다.

도구

두 create_* 도구 모두 렌더링을 최종본으로 간주하기 전에 Remotion Studio(npm run dev → localhost:3000)에서 컴포지션을 여는 방법을 알려주는 preview 힌트를 반환합니다.

Related MCP server: cutgent

설정

1. Python 의존성 클론 및 설치

git clone https://github.com/<your-username>/remotion-mcp-server.git
cd remotion-mcp-server
pip install -r requirements.txt

PATH에 ffmpeg도 필요합니다(또는 서버가 자동으로 폴백하는 imageio-ffmpeg를 설치해도 됩니다).

2. Remotion 프로젝트 설정

이 서버는 생성된 컴포지션을 작성하고 렌더링할 Remotion 프로젝트가 필요합니다. 바로 사용할 수 있는 스타터가 포함되어 있습니다:

cd remotion-template
npm install
cd ..

또는 REMOTION_MCP_PROJECT를 자신의 기존 Remotion 프로젝트로 지정하세요 — Root.tsx에 remotion-template/src/Root.tsx의 두 마커 주석만 있으면 됩니다.

3. 구성(선택 사항)

.env.example을 .env로 복사하고 기본값을 사용하지 않는 경우 조정하세요(사용자 지정 yt-dlp/ffmpeg 경로, 다른 프로젝트 폴더, 기본 워터마크).

4. Claude에 등록

Claude Desktop / Claude Code MCP 구성에 추가하세요:

{
  "mcpServers": {
    "remotion-video": {
      "command": "python",
      "args": ["/absolute/path/to/remotion-mcp-server/server.py"]
    }
  }
}

Claude를 다시 시작하고 참조 릴을 분석하여 같은 스타일로 하나 만들어 달라고 요청하세요.

작동 방식

• analyze_video는 yt-dlp로 다운로드하고 ffmpeg로 프레임 + 오디오를 추출한 다음 트랜스크립트를 생성합니다: 먼저 youtube-transcript-api로 YouTube 자막을 사용하고, 그 외 모든 것은 로컬 faster-whisper 트랜스크립션으로 폴백합니다.

• create_dialogue_reel / create_facts_reel은 .tsx 컴포지션 파일을 템플릿으로 생성하고, 마커 주석 사이의 Remotion 프로젝트 Root.tsx에 등록한 다음 npx remotion render를 호출합니다.

• 생성된 컴포지션은 핫 리로드를 통해 Remotion Studio(npm run dev)에 실시간으로 표시됩니다 — 재시작 불필요 — 따라서 렌더링을 최종본으로 간주하기 전에 프레임 단위로 검토할 수 있습니다.

라이선스

MIT — LICENSE 참조.