AI Video Generator MCP Server

이 MCP(Model Context Protocol) 서버는 AI 이미지 생성 모델을 사용하여 텍스트 프롬프트와 이미지에서 동영상을 생성하는 도구를 제공합니다.

대응 모델

• Luma Ray2 Flash - Luma의 최첨단 이미지 → 동영상 변환 모델

• Kling v1.6 Pro - Kling의 고품질 이미지 → 동영상 변환 모델

Related MCP server: AllVoiceLab-MCP

기능

• 텍스트 프롬프트에서 동영상 생성

• 시작 및/또는 종료 이미지를 사용하여 동영상 생성

• 동영상 매개변수 제어(종횡비, 해상도, 길이, 루프)

• 생성 상태 확인

• 사용할 AI 모델 선택

설치

1. 이 저장소를 복제합니다.

2. 종속성을 설치합니다.

   npm install

3. .env 파일을 만들고 FAL.AI API 키를 설정합니다.

   FAL_KEY=your_fal_key_here

   API 키는 FAL.AI 에서 얻을 수 있습니다.

서버 빌드

서버 실행

서버를 직접 실행할 수 있습니다.

Claude Desktop과의 통합

이 서버를 Claude Desktop에서 사용하려면 claude_desktop_config.json 파일에 다음과 같이 추가합니다.

사용 가능한 도구

generate-video

AI 모델을 사용하여 텍스트 프롬프트 및/또는 이미지에서 동영상을 생성합니다.

매개변수:

• prompt (필수): 생성하려는 동영상의 내용 텍스트 설명

• image_url (선택사항): 동영상의 시작 이미지 URL(URL 또는 base64 데이터 URI)

• end_image_url (선택 사항): 동영상의 종료 이미지 URL(URL 또는 base64 데이터 URI)

• aspect_ratio (기본값 "16:9"): 동영상의 화면 비율("16:9", "9:16", "4:3", "3:4", "21:9", "9:21")

• resolution (기본값 "540p"): 동영상 해상도("540p", "720p", "1080p")

• duration (기본 "5s"): 동영상 길이("5s", "9s")

• loop (기본값 false): 동영상을 반복할지 여부

• model (기본 "luma"): 사용할 AI 모델("luma"=Ray2, "kling"=Kling v1.6 Pro)

check-video-status

동영상 생성 요청의 상태를 확인합니다.

매개변수:

• request_id (필수): 확인할 요청 ID

• model (기본 "luma"): 요청에 사용된 AI 모델("luma"=Ray2, "kling"=Kling v1.6 Pro)

Claude에서의 사용 예

Claude는 적절한 매개 변수로 generate-video 도구를 호출하여 결과 동영상 URL을 제공합니다.

모델 비교

• Luma Ray2 Flash : 부드러운 움직임과 현실적인 물리 거동이 뛰어나 자연스러운 결과를 얻을 수 있습니다.

• Kling v1.6 Pro : 상세한 질감과 특수 효과가 뛰어나며 스타일화된 결과를 얻을 수 있습니다.

프롬프트와 원하는 결과에 따라 최적의 모델이 다를 수 있습니다.

제한사항

• 동영상을 생성하는 데 시간이 걸릴 수 있습니다(특히 고해상도인 경우).

• 유효한 FAL.AI API 키와 충분한 크레딧이 필요합니다.

• 고해상도 및 긴 동영상은 더 많은 크레딧을 소모합니다.

• 두 모델 모두 FAL.AI 크레딧을 소비합니다 (요금은 모델마다 다를 수 있음)

문제해결

API 키 오류

FAL_KEY 환경 변수가 올바르게 설정되었는지 확인합니다. Claude Desktop 구성 파일에서 직접 설정할 수도 있습니다.

동영상 생성 오류

동영상 생성 중에 오류가 발생하면 자세한 오류 메시지가 기록됩니다. 일반적인 문제는 :

• API 키가 잘못되었거나 만료됨

• 계정 크레딧 부족

• 부적절한 프롬프트 또는 이미지

• 서버 측 임시 문제

오류가 계속되면 잠시 기다렸다가 다시 시도하거나 프롬프트를 변경해 보십시오.

라이센스

MIT