Vidu MCP 서버

Vidu 비디오 생성 API와 상호 작용하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 Vidu의 강력한 AI 모델을 사용하여 이미지에서 비디오를 생성하는 도구를 제공합니다.

특징

• 이미지를 비디오로 변환 : 사용자 정의 가능한 설정으로 정적 이미지에서 비디오를 생성합니다.
• 생성 상태 확인 : 비디오 생성 작업의 진행 상황을 모니터링합니다.
• 이미지 업로드 : Vidu API와 함께 사용할 이미지를 쉽게 업로드하세요

필수 조건

• Node.js(v14 이상)
• Vidu API 키( Vidu 웹사이트 에서 사용 가능)
• TypeScript(개발용)

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Vidu Video Generation Server를 자동으로 설치하려면:

지엑스피1

수동 설치

1. 이 저장소를 복제하세요:

2. 종속성 설치:

3. .env.template 기반으로 .env 파일을 만들고 Vidu API 키를 추가합니다.

용법

1. TypeScript 코드를 작성합니다.

2. 서버를 시작합니다:

MCP 서버가 시작되고 MCP 클라이언트의 연결을 수락할 준비가 됩니다.

도구

1. 이미지를 비디오로

사용자 정의 가능한 매개변수를 사용하여 정적 이미지를 비디오로 변환합니다.

매개변수:

• image_url (필수): 비디오로 변환할 이미지의 URL
• prompt (선택 사항): 비디오 생성을 위한 텍스트 프롬프트(최대 1500자)
• duration (선택 사항): 출력 비디오의 지속 시간(초)(4 또는 8, 기본값 4)
• model (선택 사항): 생성을 위한 모델 이름("vidu1.0", "vidu1.5", "vidu2.0", 기본값 "vidu2.0")
• resolution (선택 사항): 출력 비디오의 해상도("360p", "720p", "1080p", 기본값 "720p")
• movement_amplitude (선택 사항): 프레임 내 객체의 이동 진폭("auto", "small", "medium", "large", 기본값 "auto")
• seed (선택 사항): 재현성을 위한 무작위 시드

요청 예시:

2. 세대 상태 확인

실행 중인 비디오 생성 작업의 상태를 확인합니다.

매개변수:

• task_id (필수): 이미지-비디오 도구에서 반환된 작업 ID

요청 예시:

3. 이미지 업로드

Vidu API와 함께 사용할 이미지를 업로드합니다.

매개변수:

• image_path (필수): 이미지 파일의 로컬 경로
• image_type (필수): 이미지 파일 유형("png", "webp", "jpeg", "jpg")

요청 예시:

작동 원리

서버는 모델 컨텍스트 프로토콜(MCP)을 사용하여 AI 도구에 표준화된 인터페이스를 제공합니다. 서버를 시작하면 표준 입출력 채널을 통해 명령을 수신하고 구조화된 형식으로 결과를 응답합니다.

서버는 다음을 포함하여 Vidu API와 상호 작용하는 모든 복잡한 작업을 처리합니다.

• API 키를 사용한 인증
• 파일 업로드 및 형식 검증
• 비동기 작업 관리 및 폴링
• 오류 처리 및 보고

문제 해결

• API 키 문제 : Vidu API 키가 .env 파일에 올바르게 설정되어 있는지 확인하세요.
• 파일 업로드 오류 : 이미지 파일이 유효하고 크기가 10MB 이하인지 확인하세요.
• 연결 문제 : 인터넷에 접속할 수 있고 Vidu API 서버에 접속할 수 있는지 확인하세요.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.