루마 AI MCP 서버 🎥

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

개요

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

특징 ✨

텍스트-비디오 생성
키프레임을 사용한 고급 비디오 생성
이미지-비디오 변환
비디오 확장 및 보간
참조 이미지를 사용한 이미지 생성
비디오에 오디오 추가
비디오 업스케일링
신용 관리
세대 추적 및 상태 확인

도구 🛠️

ping
- Luma API가 실행 중인지 확인하세요
- 매개변수가 필요하지 않습니다
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"}
get_generation
- 세대의 상태를 가져옵니다
- 입력:
  - generation_id (문자열, 필수): 확인할 세대의 ID
- 출력에는 다음이 포함됩니다.
  - 세대 ID
  - 상태(대기, 꿈, 완료, 실패)
  - 실패 이유(실패한 경우)
  - 비디오 URL(완료된 경우)
list_generations
- 모든 세대를 나열합니다
- 입력:
  - limit (숫자, 선택 사항): 반환할 최대 세대 수(기본값: 10)
  - offset (숫자, 선택 사항): 건너뛸 세대 수
delete_generation
- 세대를 삭제합니다
- 입력:
  - generation_id (문자열, 필수): 삭제할 세대의 ID
upscale_generation
- 비디오 생성을 더 높은 해상도로 업스케일합니다.
- 입력:
  - generation_id (문자열, 필수): 업스케일할 세대의 ID
  - resolution (문자열, 필수): 업스케일된 비디오의 대상 해상도("540p", "720p", "1080p" 또는 "4k" 중 하나)
- 메모:
  - 업스케일링하려면 세대가 완료된 상태여야 합니다.
  - 대상 해상도는 원래 세대의 해상도보다 높아야 합니다.
  - 각 세대는 한 번만 확장할 수 있습니다.
add_audio
- AI가 생성한 오디오를 비디오 생성에 추가합니다.
- 입력:
  - generation_id (필수): 오디오를 추가할 세대의 ID
  - prompt (필수): 오디오 생성을 위한 프롬프트
  - negative_prompt (선택 사항): 오디오 생성을 위한 부정 프롬프트
  - callback_url (선택 사항): 오디오 처리가 완료되면 알림을 보낼 URL
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}
get_credits
- 현재 사용자의 신용 정보를 가져옵니다.
- 매개변수가 필요하지 않습니다
- 사용 가능한 신용 잔액을 USD 센트로 반환합니다.
get_camera_motions

지원되는 모든 카메라 모션을 가져옵니다.
매개변수가 필요하지 않습니다
반환: 사용 가능한 카메라 모션 문자열 목록

Claude Desktop 설정 🖥️

Luma AI 에서 Luma API 키를 받으세요(가입하거나 로그인하여 API 키를 받으세요)
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
Claude Desktop을 다시 시작하세요
이제 Claude Desktop 대화에서 Luma AI 도구를 바로 사용할 수 있습니다.

빠른 문제 해결 🛠️

문제가 있는 경우:

API 키가 올바른지 확인하세요
서버 경로가 올바른지 확인하세요
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log 사용하여 로그를 확인하세요.

고급 비디오 생성 유형 🎬

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

이미지에서 시작 : frame0 에 type: "image" 및 이미지 URL을 제공합니다.
이미지로 마무리 : frame1 에 type: "image" 및 이미지 URL을 제공합니다.
비디오 확장 : frame0 에 type: "generation" 과 세대 ID를 제공합니다.
비디오 역방향 확장 : frame1 에 type: "generation" 과 세대 ID를 제공합니다.
비디오 간 보간 : 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

mcp-luma-dream-machine

Integrations