루마 AI MCP 서버 🎥

Luma AI의 Dream Machine API를 위한 모델 컨텍스트 프로토콜 서버입니다.

개요

이 MCP 서버는 Luma AI의 Dream Machine API(v1)와 통합되어 대규모 언어 모델(LML)을 통해 AI가 생성한 비디오 및 이미지를 생성, 관리 및 조작하는 도구를 제공합니다. 또한, 모델 컨텍스트 프로토콜(MCP)을 구현하여 AI 어시스턴트와 Luma의 크리에이티브 도구 간의 원활한 상호작용을 지원합니다.

Related MCP server: mcp-media-engine

특징 ✨

• 텍스트-비디오 생성

• 키프레임을 사용한 고급 비디오 생성

• 이미지-비디오 변환

• 비디오 확장 및 보간

• 참조 이미지를 사용한 이미지 생성

• 비디오에 오디오 추가

• 비디오 업스케일링

• 신용 관리

• 세대 추적 및 상태 확인

도구 🛠️

1. ping

   • Luma API가 실행 중인지 확인하세요

   • 매개변수가 필요하지 않습니다

2. create_generation

   • 새로운 비디오 세대를 만듭니다

   • 입력:

     • prompt (문자열, 필수): 생성할 비디오의 텍스트 설명

     • model (문자열, 선택 사항): 사용할 모델(기본값: "ray-2")

       • 사용 가능한 모델: "ray-1-6", "ray-2", "ray-flash-2"

     • resolution (문자열, 선택 사항): 비디오 해상도(선택 사항: "540p", "720p", "1080p", "4k")

     • duration (문자열, 선택 사항): 비디오 지속 시간(현재 "5초"와 "9초"만 지원됨)

     • aspect_ratio (문자열, 선택 사항): 비디오 종횡비(예: "16:9", "1:1", "9:16", "4:3", "3:4", "21:9", "9:21")

     • loop (부울, 선택 사항): 비디오를 루프할지 여부

     • keyframes (객체, 선택 사항): 고급 비디오 생성을 위한 시작 및 종료 프레임:

       • frame0 및/또는 frame1 중 하나:

         • 이미지 키프레임의 경우 {"type": "image", "url": "image_url"}

         • 비디오 키프레임의 경우 {"type": "generation", "id": "generation_id"}

3. get_generation

   • 세대의 상태를 가져옵니다

   • 입력:

     • generation_id (문자열, 필수): 확인할 세대의 ID

   • 출력에는 다음이 포함됩니다.

     • 세대 ID

     • 상태(대기, 꿈, 완료, 실패)

     • 실패 이유(실패한 경우)

     • 비디오 URL(완료된 경우)

4. list_generations

   • 모든 세대를 나열합니다

   • 입력:

     • limit (숫자, 선택 사항): 반환할 최대 세대 수(기본값: 10)

     • offset (숫자, 선택 사항): 건너뛸 세대 수

5. delete_generation

   • 세대를 삭제합니다

   • 입력:

     • generation_id (문자열, 필수): 삭제할 세대의 ID

6. upscale_generation

   • 비디오 생성을 더 높은 해상도로 업스케일합니다.

   • 입력:

     • generation_id (문자열, 필수): 업스케일할 세대의 ID

     • resolution (문자열, 필수): 업스케일된 비디오의 대상 해상도("540p", "720p", "1080p" 또는 "4k" 중 하나)

   • 메모:

     • 업스케일링하려면 세대가 완료된 상태여야 합니다.

     • 대상 해상도는 원래 세대의 해상도보다 높아야 합니다.

     • 각 세대는 한 번만 확장할 수 있습니다.

7. add_audio

   • AI가 생성한 오디오를 비디오 생성에 추가합니다.

   • 입력:

     • generation_id (필수): 오디오를 추가할 세대의 ID

     • prompt (필수): 오디오 생성을 위한 프롬프트

     • negative_prompt (선택 사항): 오디오 생성을 위한 부정 프롬프트

     • callback_url (선택 사항): 오디오 처리가 완료되면 알림을 보낼 URL

8. generate_image

   • 선택적 참조 이미지가 포함된 텍스트 프롬프트에서 이미지를 생성합니다.

   • 입력:

     • prompt (문자열, 필수): 생성할 이미지에 대한 텍스트 설명

     • model (문자열, 선택 사항): 이미지 생성에 사용할 모델(기본값: "photon-1")

       • 사용 가능한 모델: "photon-1", "photon-flash-1"

     • aspect_ratio (문자열, 선택 사항): 이미지 종횡비(비디오와 동일한 옵션)

     • image_ref (배열, 선택 사항): 생성을 안내하는 참조 이미지

       • 각 참조: {"url": "image_url", "weight": optional_float}

     • style_ref (배열, 선택 사항): 스타일 참조 이미지

       • 각 참조: {"url": "image_url", "weight": optional_float}

     • character_ref (객체, 선택 사항): 캐릭터 참조 이미지

       • 형식: {"identity_name": {"images": ["url1", "url2", ...]}}

     • modify_image_ref (객체, 선택 사항): 수정할 이미지

       • 형식: {"url": "image_url", "weight": optional_float}

9. get_credits

   • 현재 사용자의 신용 정보를 가져옵니다.

   • 매개변수가 필요하지 않습니다

   • 사용 가능한 신용 잔액을 USD 센트로 반환합니다.

10. get_camera_motions

• 지원되는 모든 카메라 모션을 가져옵니다.

• 매개변수가 필요하지 않습니다

• 반환: 사용 가능한 카메라 모션 문자열 목록

Claude Desktop 설정 🖥️

1. Luma AI 에서 Luma API 키를 받으세요(가입하거나 로그인하여 API 키를 받으세요)

2. Claude Desktop 구성 파일에 다음을 추가하세요.

   • macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json

   지엑스피1

   바꾸다:

   • /path/to/your/luma-ai-mcp-server 서버 디렉토리의 실제 경로를 추가합니다.

   • 실제 Luma API 키와 함께 your-luma-api-key-here

3. Claude Desktop을 다시 시작하세요

4. 이제 Claude Desktop 대화에서 Luma AI 도구를 바로 사용할 수 있습니다.

빠른 문제 해결 🛠️

문제가 있는 경우:

1. API 키가 올바른지 확인하세요

2. 서버 경로가 올바른지 확인하세요

3. tail -n 20 -f ~/Library/Logs/Claude/mcp*.log 사용하여 로그를 확인하세요.

고급 비디오 생성 유형 🎬

Luma API는 키프레임을 통해 다양한 유형의 고급 비디오 생성을 지원합니다.

1. 이미지에서 시작 : frame0 에 type: "image" 및 이미지 URL을 제공합니다.

2. 이미지로 마무리 : frame1 에 type: "image" 및 이미지 URL을 제공합니다.

3. 비디오 확장 : frame0 에 type: "generation" 과 세대 ID를 제공합니다.

4. 비디오 역방향 확장 : frame1 에 type: "generation" 과 세대 ID를 제공합니다.

5. 비디오 간 보간 : frame0 과 frame1 모두에 type: "generation" 과 세대 ID를 제공합니다.

API 제한 사항 및 참고 사항 📝

• 지속 시간 : 현재 API는 "5초" 또는 "9초"의 지속 시간만 지원합니다.

• 해상도 : 유효한 값은 "540p", "720p", "1080p" 및 "4k"입니다.

• 모델 :

  • 비디오 생성:

    • "ray-2"(기본값) - 최상의 품질, 더 느림

    • "ray-flash-2" - 더 빠른 생성

    • "ray-1-6" - 레거시 모델

  • 이미지 생성:

    • "photon-1"(기본값) - 최상의 품질, 느림

    • "photon-flash-1" - 더 빠른 생성

• 생성 유형 : 비디오, 이미지 및 고급(키프레임 포함)

• 화면 비율 : "1:1"(정사각형), "16:9"(가로), "9:16"(세로), "4:3"(표준), "3:4"(표준 세로), "21:9"(울트라와이드), "9:21"(울트라와이드 세로)

• 상태 : "대기 중", "꿈꾸는 중", "완료", "실패"

• 업스케일링 :

  • 비디오 세대는 "완료" 상태일 때만 업스케일링할 수 있습니다.

  • 대상 해상도는 원래 세대의 해상도보다 높아야 합니다.

  • 각 세대는 한 번만 확장할 수 있습니다.

• API 키 : 환경 변수에 필요함

• API 버전 : Dream Machine API v1 사용

라이센스 📄

MIT