MCP Video Generation with Veo2

Veo2를 사용한 MCP 비디오 생성

이 프로젝트는 Google의 Veo2 비디오 생성 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버를 구현합니다. 클라이언트가 텍스트 프롬프트나 이미지에서 비디오를 생성하고, MCP 리소스를 통해 생성된 비디오에 접근할 수 있도록 지원합니다.

특징

• 텍스트 프롬프트에서 비디오 생성
• 이미지에서 비디오 생성
• MCP 리소스를 통해 생성된 비디오에 액세스하세요
• 비디오 생성 템플릿 예시
• stdio 및 SSE 전송 모두 지원

예시 이미지

예시 이미지를 비디오로

이미지에서 비디오로 - Grok에서 생성된 강아지

이미지를 비디오로 - 실제 고양이로부터

필수 조건

• Node.js 18 이상
• Gemini API와 Veo2 모델에 액세스할 수 있는 Google API 키(= API 키로 신용 카드를 설정해야 합니다! -> aistudio.google.com으로 이동)

설치

FLUJO 에 설치하기

1. 서버 추가를 클릭하세요
2. Github URL을 복사하여 FLUJO에 붙여넣기
3. 분석, 복제, 설치, 빌드 및 저장을 클릭합니다.

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 mcp-video-generation-veo2를 자동으로 설치하려면 다음을 수행합니다.

지엑스피1

수동 설치

1. 저장소를 복제합니다.
   git clone https://github.com/yourusername/mcp-video-generation-veo2.git cd mcp-video-generation-veo2
2. 종속성 설치:
   npm install
3. Google API 키로 .env 파일을 만듭니다.
   cp .env.example .env # Edit .env and add your Google API key
   .env 파일은 다음 변수를 지원합니다.
   • GOOGLE_API_KEY : Google API 키(필수)
   • PORT : 서버 포트(기본값: 3000)
   • STORAGE_DIR : 생성된 비디오를 저장하는 디렉토리(기본값: ./generated-videos)
   • LOG_LEVEL : 로깅 수준(기본값: 치명적)
     • 사용 가능한 레벨: 자세한 정보, 디버그, 정보, 경고, 오류, 치명적, 없음
     • 개발의 경우 더 자세한 로그를 보려면 debug 또는 info 로 설정하세요.
     • 생산을 위해 콘솔 출력을 최소화하기 위해 fatal 이라고 유지하십시오.
4. 프로젝트를 빌드하세요:
   npm run build

용법

서버 시작

stdio 또는 SSE 전송을 사용하여 서버를 시작할 수 있습니다.

stdio 전송(기본값)

SSE 운송

이렇게 하면 서버가 포트 3000(또는 .env 파일에 지정된 포트)에서 시작됩니다.

MCP 도구

서버는 다음과 같은 MCP 도구를 제공합니다.

텍스트에서 비디오 생성

텍스트 프롬프트에서 비디오를 생성합니다.

매개변수:

• prompt (문자열): 비디오 생성을 위한 텍스트 프롬프트
• config (객체, 선택 사항): 구성 옵션
  • aspectRatio (문자열, 선택 사항): "16:9" 또는 "9:16"
  • personGeneration (문자열, 선택 사항): "dont_allow" 또는 "allow_adult"
  • numberOfVideos (숫자, 선택 사항): 1 또는 2
  • durationSeconds (숫자, 선택 사항): 5~8 사이
  • enhancePrompt (boolean, 선택 사항): 프롬프트를 향상시킬지 여부
  • negativePrompt (문자열, 선택 사항): 생성하지 않을 내용을 설명하는 텍스트

예:

이미지에서 비디오 생성

이미지에서 비디오를 생성합니다.

매개변수:

• image (문자열): Base64로 인코딩된 이미지 데이터
• prompt (문자열, 선택 사항): 비디오 생성을 안내하는 텍스트 프롬프트
• config (객체, 선택 사항): 구성 옵션(위와 동일하지만 personGeneration은 "dont_allow"만 지원함)

목록 생성 비디오

생성된 모든 비디오를 나열합니다.

MCP 리소스

서버는 다음과 같은 MCP 리소스를 제공합니다.

비디오://{id}

ID로 생성된 비디오에 접근합니다.

비디오://템플릿

비디오 생성 템플릿의 예를 살펴보세요.

개발

프로젝트 구조

• src/ : 소스 코드
  • index.ts : 메인 진입점
  • server.ts : MCP 서버 구성
  • config.ts : 구성 처리
  • tools/ : MCP 도구 구현
  • resources/ : MCP 리소스 구현
  • services/ : 외부 서비스 통합
  • utils/ : 유틸리티 함수

건물

개발 모드

특허

MIT