AI Video Generator MCP Server

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

대응 모델

Luma Ray2 Flash - Luma의 최첨단 이미지 → 동영상 변환 모델
Kling v1.6 Pro - Kling의 고품질 이미지 → 동영상 변환 모델

기능

텍스트 프롬프트에서 동영상 생성
시작 및/또는 종료 이미지를 사용하여 동영상 생성
동영상 매개변수 제어(종횡비, 해상도, 길이, 루프)
생성 상태 확인
사용할 AI 모델 선택

설치

이 저장소를 복제합니다.
종속성을 설치합니다.
npm install
.env 파일을 만들고 FAL.AI API 키를 설정합니다.
FAL_KEY=your_fal_key_here
API 키는 FAL.AI 에서 얻을 수 있습니다.

서버 빌드

npm run build

서버 실행

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

npm start

Claude Desktop과의 통합

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

{
  "mcpServers": {
    "video-generator": {
      "command": "node",
      "args": ["your_install_path/fal-mcp-server/build/index.js"],
      "env": {
        "FAL_KEY": "your_fal_key_here"
      }
    }
  }
}

사용 가능한 도구

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에서의 사용 예

猫が毛糸玉で遊んでいる動画を生成してください。縦向きモードでお願いします。Klingモデルを使用してください。

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

모델 비교

Luma Ray2 Flash : 부드러운 움직임과 현실적인 물리 거동이 뛰어나 자연스러운 결과를 얻을 수 있습니다.
Kling v1.6 Pro : 상세한 질감과 특수 효과가 뛰어나며 스타일화된 결과를 얻을 수 있습니다.

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

제한사항

동영상을 생성하는 데 시간이 걸릴 수 있습니다(특히 고해상도인 경우).
유효한 FAL.AI API 키와 충분한 크레딧이 필요합니다.
고해상도 및 긴 동영상은 더 많은 크레딧을 소모합니다.
두 모델 모두 FAL.AI 크레딧을 소비합니다 (요금은 모델마다 다를 수 있음)

문제해결

API 키 오류

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

동영상 생성 오류

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

API 키가 잘못되었거나 만료됨
계정 크레딧 부족
부적절한 프롬프트 또는 이미지
서버 측 임시 문제

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

라이센스

MIT