RunwayML + Luma AI MCP Server

RunwayML + Luma AI MCP 서버

이 MCP 서버는 비디오 및 이미지 생성 작업을 위해 RunwayML 및 Luma AI API와 상호 작용할 수 있는 도구를 제공합니다.

특징

• 텍스트 프롬프트(RunwayML 또는 Luma AI)에서 비디오를 생성합니다.
• 이미지(RunwayML 또는 Luma AI)에서 비디오를 생성합니다.
• 텍스트 프롬프트에서 이미지를 생성합니다(Luma AI).
• Luma AI 세대를 관리합니다(목록, 가져오기, 삭제).
• Luma AI 세대에 오디오를 추가합니다.
• 고급 Luma AI 세대.
• 생성 전에 OpenRouter LLM을 사용하여 프롬프트를 향상시킵니다.

필수 조건

• Node.js(v18 LTS 이상 권장)
• npm(일반적으로 Node.js에 포함됨)
• API 키:
  • RunwayML API 비밀
  • 루마 AI API 키
  • OpenRouter API 키( enhance_prompt 도구용)

설치

1. 복제 또는 다운로드: 서버 코드를 얻습니다.
2. 디렉토리로 이동: 서버의 루트 디렉토리( runwayml-mcp-server )에서 터미널을 엽니다.
3. 종속성 설치:지엑스피1

구성

1. .env 파일 만들기: 서버의 루트 디렉토리에 .env 라는 이름의 파일을 만듭니다.
2. API 키 추가: API 키를 .env 파일에 추가합니다.
   RUNWAYML_API_SECRET=your_runwayml_api_secret_here LUMAAI_API_KEY=your_luma_api_key_here OPENROUTER_API_KEY=your_openrouter_api_key_here
   플레이스홀더 값을 실제 키로 바꾸세요.

서버 실행

1. 서버 빌드: TypeScript 코드를 컴파일합니다.
   npm run build
2. 서버를 시작합니다:
   npm start
   터미널의 오류 출력(stderr)에서 RunwayML MCP server running on stdio 라는 메시지가 표시되어야 합니다.

MCP 클라이언트 설정(예: Claude Desktop App, Cline)

이 서버에 연결하도록 MCP 클라이언트를 구성하세요. 정확한 단계는 클라이언트에 따라 다르지만 일반적으로 다음을 제공해야 합니다.

• 이름: 설명적 이름(예: runway-luma-server )
• 명령어: node
• 인수: 컴파일된 서버 인덱스 파일의 전체 경로(예: /path/to/your/runwayml-mcp-server/build/server-index.js )
• 환경 변수:
  • RUNWAYML_API_SECRET : RunwayML API 비밀번호
  • LUMAAI_API_KEY : Luma AI API 키
  • OPENROUTER_API_KEY : OpenRouter API 키

구성 예시(개념적):

(시스템의 실제 경로로 /full/path/to/ 를 바꾸는 것을 잊지 마세요)

사용 가능한 도구

• generate_text_to_video : 텍스트에서 비디오를 생성합니다.
  • provider : (선택 사항) runwayml (기본값) 또는 lumaai .
  • promptText : (필수) 텍스트 프롬프트.
  • runway_model : (선택 사항) 활주로 모델(예: "gen-2").
  • runway_resolution : (선택 사항) 활주로 해상도( 1280:768 또는 768:1280 ).
  • runway_watermark : (선택 사항) 부울, 기본값은 false .
  • luma_model : (선택 사항) Luma 모델( ray-flash-2 , ray-2 (기본값), ray-1-6 ).
  • luma_aspect_ratio : (선택 사항) 루마 종횡비(예: 16:9 (기본값), 1:1 ).
  • luma_loop : (선택 사항) 부울.
  • duration : (선택 사항) 비디오 길이(초)(숫자).
  • seed : (선택 사항) 세대 시드(숫자).
• generate_image_to_video : 이미지에서 비디오를 생성합니다.
  • provider : (선택 사항) runwayml (기본값) 또는 lumaai .
  • promptImage : (필수) 입력 이미지의 URL 또는 Runway의 경우 배열 [{uri: "url", position: "first" | "last"}] .
  • promptText : (선택 사항) 이미지와 함께 표시되는 텍스트 프롬프트입니다.
  • runway_model : (선택 사항) 활주로 모델( gen3a_turbo (기본값)).
  • runway_duration : (선택 사항) 활주로 지속 시간( 5 (기본값) 또는 10 ).
  • runway_ratio : (선택 사항) 활주로 해상도( 1280:768 또는 768:1280 ).
  • runway_watermark : (선택 사항) 부울, 기본값은 false .
  • luma_model : (선택 사항) Luma 모델( ray-flash-2 , ray-2 (기본값), ray-1-6 ).
  • luma_aspect_ratio : (선택 사항) 루마 종횡비(예: 16:9 (기본값)).
  • luma_loop : (선택 사항) 부울.
  • seed : (선택 사항) 세대 시드(숫자).
• enhance_prompt : OpenRouter를 사용하여 프롬프트를 개선합니다.
  • original_prompt : (필수) 향상시킬 프롬프트입니다.
  • model : (선택 사항) OpenRouter 모델 이름(기본값은 anthropic/claude-3.5-sonnet 과 같은 유능한 모델).
  • instructions : (선택 사항) 향상을 위한 구체적인 지침입니다.
• luma_generate_image : Luma AI를 사용하여 이미지를 생성합니다.
  • prompt : (필수) 텍스트 프롬프트.
  • aspect_ratio : (선택 사항) 루마 종횡비( 16:9 (기본값)).
  • model : (선택 사항) 루마 이미지 모델( photon-1 (기본값), photon-flash-1 ).
  • image_ref : (선택 사항) 이미지 참조 객체 배열( {url: string, weight?: number} ). 최대 4개.
  • style_ref : (선택 사항) 스타일 참조 객체 배열( {url: string, weight?: number} ). 최대 1개.
  • character_ref : (선택 사항) 문자 참조 객체( { identity0: { images: [url1, ...] } } ).
  • modify_image_ref : (선택 사항) 이미지 참조 객체( {url: string, weight?: number} )를 수정합니다.
• luma_list_generations : 이전 Luma AI 세대를 나열합니다.
  • limit : (선택 사항) 결과 수(기본값 10).
  • offset : (선택 사항) 페이지 매김을 위한 오프셋(기본값 0).
• luma_get_generation : 특정 Luma AI 세대에 대한 세부 정보를 가져옵니다.
  • generation_id : (필수) 세대의 UUID.
• luma_delete_generation : 특정 Luma AI 세대를 삭제합니다.
  • generation_id : (필수) 세대의 UUID.
• luma_get_camera_motions : Luma AI 프롬프트에 지원되는 카메라 모션을 나열합니다. (매개변수 없음)
• luma_add_audio : 루마 생성에 오디오를 추가합니다.
  • generation_id : (필수) 세대의 UUID.
  • prompt : (필수) 오디오에 대한 프롬프트입니다.
  • negative_prompt : (선택 사항) 오디오에 대한 부정적 프롬프트입니다.
• luma_upscale : 루마 생성을 업스케일합니다.
  • generation_id : (필수) 세대의 UUID.
  • resolution : (선택 사항) 대상 해상도( 1080p (기본값) 또는 4k ).

(참고: 생성( generate_* , luma_upscale )과 관련된 도구의 경우, 서버가 작업을 시작하고 즉시 반환합니다. 진행 상황 업데이트와 최종 결과 URL은 MCP 진행 상황 알림을 통해 전송됩니다.)

예제 워크플로

일반적인 사용 사례에 맞게 서버 도구를 결��하는 방법의 예는 다음과 같습니다.

1. 뮤직 비디오 스니펫(사이버펑크 누아르)

목표: "크롬 도시를 흐르는 네온 강"이라는 가사로 5초 분량의 사이버펑크 누아르 영상 클립을 만듭니다.

단계:

1. 기본 이미지(루마) 생성:
   { "tool_name": "luma_generate_image", "arguments": { "prompt": "Overhead shot of a dark, rainy cyberpunk city street at night. Bright neon signs reflect on wet pavement, resembling rivers of light flowing between towering chrome skyscrapers. Film noir aesthetic, photorealistic.", "aspect_ratio": "16:9" } }
   (이미지 생성이 완료될 때까지 기다렸다가 이미지 URL을 받으세요)
2. 애니메이션 이미지(루마):
   { "tool_name": "generate_image_to_video", "arguments": { "provider": "lumaai", "promptImage": "{IMAGE_URL_FROM_STEP_1}", "promptText": "Slow pan left across the rainy cyberpunk cityscape, neon lights flickering subtly.", "luma_aspect_ratio": "16:9", "duration": 5 } }
   (비디오 생성이 완료될 때까지 기다리세요)

2. 제품 광고 컨셉 (플로팅 이어버드)

목표: 미니멀한 환경에 떠 있는 미래형 이어버드를 보여주는 5초 분량의 영상을 만듭니다.

단계:

1. 제품 참조를 사용하여 장면 생성(Luma):
   { "tool_name": "luma_generate_image", "arguments": { "prompt": "A single, sleek futuristic wireless earbud floats weightlessly in the center of a bright, minimalist white room with soft, diffused ambient light. Zero gravity effect.", "aspect_ratio": "1:1", "image_ref": [{ "url": "{PRODUCT_IMAGE_URL}", "weight": 0.8 }] } }
   (이미지 생성이 완료될 때까지 기다렸다가 이미지 URL을 받으세요)
2. 애니메이션 장면(루마):
   { "tool_name": "generate_image_to_video", "arguments": { "provider": "lumaai", "promptImage": "{IMAGE_URL_FROM_STEP_1}", "promptText": "The earbud slowly rotates and drifts gently in zero gravity.", "luma_aspect_ratio": "1:1", "duration": 5 } }
   (비디오 생성이 완료될 때까지 기다리세요)

3. 이미지 애니메이션(RunwayML Gen3a)

목표: RunwayML의 Gen3a 모델을 사용하여 기존 이미지에 애니메이션을 적용합니다.

단계:

1. (선택 사항) 기본 이미지(루마) 생성: 이미지가 없으면 luma_generate_image 사용합니다.
2. 애니메이션 이미지(RunwayML):
   { "tool_name": "generate_image_to_video", "arguments": { "provider": "runwayml", "promptImage": "{YOUR_IMAGE_URL}", "promptText": "Subtle zoom in, cinematic lighting.", "runway_model": "gen3a_turbo", "runway_duration": "5", "runway_ratio": "1280:768" // Or "768:1280" } }
   (비디오 생성이 완료될 때까지 기다리세요)