루마 AI MCP 서버 🎥
Luma AI의 Dream Machine API를 위한 모델 컨텍스트 프로토콜 서버입니다.
개요
이 MCP 서버는 Luma AI의 Dream Machine API(v1)와 통합되어 대규모 언어 모델(LML)을 통해 AI가 생성한 비디오 및 이미지를 생성, 관리 및 조작하는 도구를 제공합니다. 또한, 모델 컨텍스트 프로토콜(MCP)을 구현하여 AI 어시스턴트와 Luma의 크리에이티브 도구 간의 원활한 상호작용을 지원합니다.
Related MCP server: Gemini MCP Server for Claude Desktop
특징 ✨
텍스트-비디오 생성
키프레임을 사용한 고급 비디오 생성
이미지-비디오 변환
비디오 확장 및 보간
참조 이미지를 사용한 이미지 생성
비디오에 오디오 추가
비디오 업스케일링
신용 관리
세대 추적 및 상태 확인
도구 🛠️
pingLuma 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(문자열, 필수): 업스케일할 세대의 IDresolution(문자열, 필수): 업스케일된 비디오의 대상 해상도("540p", "720p", "1080p" 또는 "4k" 중 하나)
메모:
업스케일링하려면 세대가 완료된 상태여야 합니다.
대상 해상도는 원래 세대의 해상도보다 높아야 합니다.
각 세대는 한 번만 확장할 수 있습니다.
add_audioAI가 생성한 오디오를 비디오 생성에 추가합니다.
입력:
generation_id(필수): 오디오를 추가할 세대의 IDprompt(필수): 오디오 생성을 위한 프롬프트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.jsonWindows의 경우:
%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