Communitygithub.com

content-studio MCP - 로컬 AI 영상 클립

Mac Studio에서 MiniMax-H3 모델을 통해 로컬로 짧은 AI 영상 클립을 생성합니다. 사용자가 /video를 입력하거나 AI 생성 클립, B-롤, 애니메이션, 이미지-투-비디오를 요청할 때 사용합니다. 품질, 화면 비율, 길이, 시작점을 클릭 가능한 옵션으로 먼저 묻습니다.

content-studio MCP - 로컬 AI 영상 클립란 무엇인가요?

이 스킬은 Mac Studio 환경에서 고성능 AI 비디오 생성 모델인 MiniMax-H3를 mlx-serve를 통해 로컬로 구동하여 짧은 AI 영상 클립을 생성하는 content-studio MCP 도구를 활용합니다. 사용자가 /video 명령어를 입력하거나 AI 생성 클립, B-롤, 애니메이션, 이미지-투-비디오를 요청할 때 자동으로 실행되며, 품질(Fast 4-bit 또는 Best 8-bit), 화면 비율(세로 릴, 가로, 정사각형), 길이(2~8초), 시작점(텍스트만, 정지 이미지 먼저 생성, 사용자 이미지)을 클릭 가능한 옵션으로 먼저 물어 사용자에게 직관적인 선택을 제공합니다. 이 스킬은 Claude Code와 OpenCode를 지원하며, 질문 호출 방식(AskUserQuestion / question)을 통해 원활한 대화형 인터페이스를 제공합니다. 또한 멀티 샷 편집을 위해 HyperFrames(/reel)와 연동하고, 음악 추가(/song 후 mux_audio) 및 잡 상태 모니터링(job_status) 기능을 포함합니다. 로컬 실행이므로 클라우드 비용이 없고, MCP 클라이언트 타임아웃(60초)을 고려하여 잡이 계속 실행 중이면 job_status를 반복 호출하여 진행 상황을 사용자에게 알려줍니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/adhyanmahajan26-boop/content-studio-mcp/tree/HEAD/skills/video

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

/video — 로컬 AI 영상 클립

도구: content-studio MCP → generate_video, generate_image, mux_audio, free_memory, job_status.

1. 질문 — 옵션이 있는 한 번의 호출

AskUserQuestion(Claude Code) / question(OpenCode) 사용; 그 외에는 번호 목록을 사용합니다. 이미 사용자가 말한 내용은 건너뜁니다.

질문옵션
모델빠름 — MiniMax-H3 4비트 (41 GB, quality:"fast") · 최고 — MiniMax-H3 8비트 (70 GB, quality:"quality")
화면 비율세로 릴 512×896 · 가로 896×512 · 정사각형 640×640
길이~2 초 (49 프레임) · ~4 초 (97 프레임) · ~8 초 (193 프레임)
시작점텍스트만 · 정지 이미지를 먼저 생성한 후 애니메이션화 · 내 이미지 (경로를 물어봄)

클립에는 자체 생성된 사운드트랙이 포함됩니다. 모델은 프레임 수를 올림 처리합니다 (49 → 56 프레임 ≈ 24fps에서 약 2.3 초). 작은 512×896 클립은 빠른 모델에서 약 2분이 소요됩니다.

세로 프레임은 사람과 거리 장면에 적합하지만, 넓은 수평 장면(바다, 풍경)은 512×896에서 가끔 옆으로 나올 수 있습니다. 이런 경우 가로를 사용하거나 클립을 사용하기 전에 프레임을 확인하세요.

2. 준비

  • "정지 이미지 먼저 생성": generate_image 실행 (품질 사전 설정, 동일한 화면 비율) 후 그 경로를 first_frame_image로 전달합니다.
  • 8비트 모델 전에 free_memory()를 호출하세요 — 약 70 GB가 필요합니다.
  • 샷 스타일 프롬프트를 작성하세요: 피사체 + 동작, 카메라 움직임 (돌리, 궤도, 핸드헬드, 슬로우 푸시인), 조명, 분위기. 클립당 하나의 샷.

3. 생성

generate_video(prompt, quality, width, height, num_frames, first_frame_image) → job_status(job_id, wait_seconds=40)가 완료될 때까지 폴링합니다.

여러 샷으로 구성된 작품의 경우 각 샷을 자체 클립으로 생성한 후 /reel(HyperFrames 편집)로 넘겨 음악과 자막과 함께 잘라서 연결합니다.

4. 전달

MP4 경로 (~/ai/content-studio/outputs/video/ 아래), 지속 시간 및 크기를 제공합니다. 제안: 다른 테이크(새 시드), 음악 추가 (/song 후 mux_audio), 또는 릴 제작.

긴 작업

도구 호출은 약 45초 내에 반환됩니다 (MCP 클라이언트는 60초에서 타임아웃). 결과에 status: "running"이 표시되면 job_status(job_id)를 계속 호출하세요 — 각 호출은 최대 40초 동안 대기합니다 — 그리고 호출 사이에 사용자에게 진행 라인을 알려주세요. 채팅이나 MCP 서버가 다시 시작되어도 작업은 계속 실행됩니다. list_jobs()로 다시 찾을 수 있습니다.

관련 스킬