mcp_gemini_generate_videos
Generate videos using the Google Veo model by providing a text prompt and optional image. Returns the file path for the created video, customizable by aspect ratio, duration, and output directory.
Instructions
Google Veo 모델을 사용하여 비디오를 생성합니다. 생성된 비디오 파일 경로를 반환하며, 이 경로는 반드시 사용자에게 알려주어야 합니다.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| aspectRatio | No | 비디오의 가로세로 비율 | 16:9 |
| durationSeconds | No | 비디오 길이(초) | |
| fileName | No | 저장할 비디오 파일 이름 (확장자 제외) | veo-1755209535150 |
| image | No | 비디오의 첫 프레임으로 사용할 이미지 (선택 사항) | |
| model | No | 사용할 모델 ID (예: veo-2.0-generate-001) | veo-2.0-generate-001 |
| numberOfVideos | No | 생성할 비디오 수 (1-2) | |
| personGeneration | No | 사람 생성 허용 설정 | dont_allow |
| prompt | Yes | 비디오 생성을 위한 텍스트 프롬프트 | |
| saveDir | No | 비디오를 저장할 디렉토리 | ./temp |
Input Schema (JSON Schema)
{
"properties": {
"aspectRatio": {
"default": "16:9",
"description": "비디오의 가로세로 비율",
"enum": [
"16:9",
"9:16"
],
"type": "string"
},
"durationSeconds": {
"default": 5,
"description": "비디오 길이(초)",
"maximum": 8,
"minimum": 5,
"type": "number"
},
"fileName": {
"default": "veo-1755209535150",
"description": "저장할 비디오 파일 이름 (확장자 제외)",
"type": "string"
},
"image": {
"description": "비디오의 첫 프레임으로 사용할 이미지 (선택 사항)",
"properties": {
"imageBytes": {
"description": "Base64로 인코딩된 이미지 데이터",
"type": "string"
},
"mimeType": {
"description": "이미지 MIME 타입 (예: image/png)",
"type": "string"
}
},
"type": "object"
},
"model": {
"default": "veo-2.0-generate-001",
"description": "사용할 모델 ID (예: veo-2.0-generate-001)",
"type": "string"
},
"numberOfVideos": {
"default": 1,
"description": "생성할 비디오 수 (1-2)",
"maximum": 2,
"minimum": 1,
"type": "number"
},
"personGeneration": {
"default": "dont_allow",
"description": "사람 생성 허용 설정",
"enum": [
"dont_allow",
"allow_adult"
],
"type": "string"
},
"prompt": {
"description": "비디오 생성을 위한 텍스트 프롬프트",
"type": "string"
},
"saveDir": {
"default": "./temp",
"description": "비디오를 저장할 디렉토리",
"type": "string"
}
},
"required": [
"prompt"
],
"type": "object"
}
Implementation Reference
- src/tools/index.ts:1231-1248 (handler)MCP tool handler for mcp_gemini_generate_videos: invokes geminiService.generateVideos with args and formats the response as ToolResponse, handling success and error cases.async handler(args: any): Promise<ToolResponse> { try { const result = await geminiService.generateVideos(args); return { content: [{ type: 'text', text: `비디오가 성공적으로 생성되었습니다. 생성된 비디오 파일: ${JSON.stringify(result.videos)}\n총 ${result.count}개의 비디오가 생성되었습니다.` }] }; } catch (error) { return { content: [{ type: 'text', text: `Gemini 비디오 생성 오류: ${error instanceof Error ? error.message : String(error)}` }] }; } }
- src/tools/index.ts:1166-1230 (schema)Input schema definition for the mcp_gemini_generate_videos tool, defining parameters like model, prompt, image, numberOfVideos, aspectRatio, etc.inputSchema: { type: 'object', properties: { model: { type: 'string', description: '사용할 모델 ID (예: veo-2.0-generate-001)', default: 'veo-2.0-generate-001', }, prompt: { type: 'string', description: '비디오 생성을 위한 텍스트 프롬프트', }, image: { type: 'object', description: '비디오의 첫 프레임으로 사용할 이미지 (선택 사항)', properties: { imageBytes: { type: 'string', description: 'Base64로 인코딩된 이미지 데이터', }, mimeType: { type: 'string', description: '이미지 MIME 타입 (예: image/png)', }, }, }, numberOfVideos: { type: 'number', description: '생성할 비디오 수 (1-2)', default: 1, minimum: 1, maximum: 2, }, aspectRatio: { type: 'string', description: '비디오의 가로세로 비율', default: '16:9', enum: ['16:9', '9:16'], }, personGeneration: { type: 'string', description: '사람 생성 허용 설정', default: 'dont_allow', enum: ['dont_allow', 'allow_adult'], }, durationSeconds: { type: 'number', description: '비디오 길이(초)', default: 5, minimum: 5, maximum: 8, }, saveDir: { type: 'string', description: '비디오를 저장할 디렉토리', default: './temp', }, fileName: { type: 'string', description: '저장할 비디오 파일 이름 (확장자 제외)', default: `veo-${Date.now()}`, }, }, required: ['prompt'] },
- src/tools/index.ts:1163-1249 (registration)Registration of mcp_gemini_generate_videos in the main tools export array used by the MCP server for listTools and callTool handlers.{ name: 'mcp_gemini_generate_videos', description: 'Google Veo 모델을 사용하여 비디오를 생성합니다. 생성된 비디오 파일 경로를 반환하며, 이 경로는 반드시 사용자에게 알려주어야 합니다.', inputSchema: { type: 'object', properties: { model: { type: 'string', description: '사용할 모델 ID (예: veo-2.0-generate-001)', default: 'veo-2.0-generate-001', }, prompt: { type: 'string', description: '비디오 생성을 위한 텍스트 프롬프트', }, image: { type: 'object', description: '비디오의 첫 프레임으로 사용할 이미지 (선택 사항)', properties: { imageBytes: { type: 'string', description: 'Base64로 인코딩된 이미지 데이터', }, mimeType: { type: 'string', description: '이미지 MIME 타입 (예: image/png)', }, }, }, numberOfVideos: { type: 'number', description: '생성할 비디오 수 (1-2)', default: 1, minimum: 1, maximum: 2, }, aspectRatio: { type: 'string', description: '비디오의 가로세로 비율', default: '16:9', enum: ['16:9', '9:16'], }, personGeneration: { type: 'string', description: '사람 생성 허용 설정', default: 'dont_allow', enum: ['dont_allow', 'allow_adult'], }, durationSeconds: { type: 'number', description: '비디오 길이(초)', default: 5, minimum: 5, maximum: 8, }, saveDir: { type: 'string', description: '비디오를 저장할 디렉토리', default: './temp', }, fileName: { type: 'string', description: '저장할 비디오 파일 이름 (확장자 제외)', default: `veo-${Date.now()}`, }, }, required: ['prompt'] }, async handler(args: any): Promise<ToolResponse> { try { const result = await geminiService.generateVideos(args); return { content: [{ type: 'text', text: `비디오가 성공적으로 생성되었습니다. 생성된 비디오 파일: ${JSON.stringify(result.videos)}\n총 ${result.count}개의 비디오가 생성되었습니다.` }] }; } catch (error) { return { content: [{ type: 'text', text: `Gemini 비디오 생성 오류: ${error instanceof Error ? error.message : String(error)}` }] }; } } },
- Core helper function implementing video generation: sends POST to Veo API, polls asynchronous operation status every 10s, downloads MP4 videos using URI with API key, saves to local temp directory, returns file paths.async generateVideos({ model, prompt, image = null, numberOfVideos = 1, aspectRatio = '16:9', personGeneration = 'dont_allow', durationSeconds = 5, saveDir = './temp', fileName = `veo-${Date.now()}`, }: { model: string; prompt: string; image?: { imageBytes: string; mimeType: string } | null; numberOfVideos?: number; aspectRatio?: string; personGeneration?: string; durationSeconds?: number; saveDir?: string; fileName?: string; }) { try { const config = this.getRequestConfig(); const url = `${this.baseUrl}/models/${model}:generateVideos`; const requestData: any = { prompt: { text: prompt, }, config: { aspectRatio, numberOfVideos, durationSeconds, personGeneration, } }; // 이미지가 제공된 경우 추가 if (image) { requestData.image = image; } // 비디오 생성 요청 시작 const response = await axios.post(url, requestData, config); // 작업 ID 가져오기 const operationName = response.data.name; if (!operationName) { throw new Error('비디오 생성 작업을 시작할 수 없습니다.'); } // 비동기 작업 상태 확인 및 완료 대기 const operationUrl = `${this.baseUrl}/${operationName}`; let operation: { done: boolean; response: any } = { done: false, response: null }; while (!operation.done) { // 10초 대기 await new Promise(resolve => setTimeout(resolve, 10000)); // 작업 상태 확인 const statusResponse = await axios.get(operationUrl, config); operation = statusResponse.data; } // 비디오 다운로드 및 저장 const fs = await import('fs'); const path = await import('path'); // 저장 디렉토리가 없으면 생성 if (!fs.existsSync(saveDir)) { fs.mkdirSync(saveDir, { recursive: true }); } const savedFiles = []; const generatedVideos = operation.response?.generatedVideos || []; for (let i = 0; i < generatedVideos.length; i++) { const videoUri = generatedVideos[i]?.video?.uri; if (videoUri) { // API 키 추가 const downloadUrl = `${videoUri}&key=${this.apiKey}`; // 비디오 다운로드 const videoResponse = await axios.get(downloadUrl, { responseType: 'arraybuffer' }); const filePath = path.join(saveDir, `${fileName}-${i + 1}.mp4`); fs.writeFileSync(filePath, Buffer.from(videoResponse.data)); savedFiles.push(filePath); } } return { model: model, prompt: prompt, videos: savedFiles, count: savedFiles.length, }; } catch (error) { throw this.formatError(error); } }
- src/index.ts:49-49 (registration)Tool capability declaration in MCP server initialization (set to false, indicating disabled but registered).mcp_gemini_generate_videos: false,