Veo2를 사용한 MCP 비디오 생성

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

특징

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

예시 이미지

예시 이미지를 비디오로

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

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

필수 조건

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

설치

FLUJO에 설치하기

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

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 mcp-video-generation-veo2를 자동으로 설치하려면:

지엑스피1

수동 설치

저장소를 복제합니다.
git clone https://github.com/yourusername/mcp-video-generation-veo2.git cd mcp-video-generation-veo2
종속성 설치:
npm install
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 이어야 합니다.
프로젝트를 빌드하세요:
npm run build

용법

서버 시작

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

stdio 전송(기본값)

npm start
# or
npm start stdio

SSE 운송

npm start 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 (문자열, 선택 사항): 생성하지 않을 내용을 설명하는 텍스트

예:

{
  "prompt": "Panning wide shot of a serene forest with sunlight filtering through the trees, cinematic quality",
  "config": {
    "aspectRatio": "16:9",
    "personGeneration": "dont_allow",
    "durationSeconds": 8
  }
}

이미지에서 비디오 생성

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

매개변수:

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/ : 유틸리티 함수

건물

npm run build

개발 모드

npm run dev

특허

MIT

MCP Video Generation with Veo2

Integrations