veo MCP

🎬 VEO 3.1 MCP服务器

使用谷歌的Veo 3.1生成令牌高效的AI视频

🎯 这是什么？

MCP服务器 谷歌的Veo 3.1 -最先进的AI视频生成模型。根据文本提示、参考图像或在第一帧/最后一帧之间插值生成令人惊叹的视频。

主要特点

• ✅ 文本转视频 -根据描述生成视频
• ✅ 参考图像 -最多3张图片用于风格指导
• ✅ 帧插值 -第一帧+最后一帧→ 相干视频
• ✅ 视频扩展 -扩展Veo生成的视频
• ✅ 批量生成 -通过并发控制生成多个视频
• ✅ 成本估算 -在生成之前了解成本
• ✅ 代币高效 -文件API的自动加载引用（节省97%的令牌！）

______________________________________________________________________

🚀 快速开始

1.安装

cd veo-mcp
npm install
npm run build

2.获取API密钥

1. 首选 谷歌人工智能工作室
2. 创建API密钥
3. 启用Veo 3.1 在您的项目中（需要计费）

3.配置

cp environment.template .env
# Edit .env and add your key

4.添加到光标

增添 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "veo": {
      "command": "node",
      "args": ["C:\\Users\\woute\\Githubs\\MCP\\veo-mcp\\dist\\index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

重新启动游标。完成！ ✅

______________________________________________________________________

🛠️ 工具

1. start_video_generation -生成视频

基本文本到视频：

{
  "prompt": "A serene Zen garden at sunrise, cherry blossoms falling, cinematic"
}

使用参考图像（令牌有效！）：

{
  "prompt": "A futuristic cityscape at night, neon lights",
  "referenceImages": [{
    "source": "url",
    "url": ""
  }],
  "durationSeconds": 8,
  "resolution": "1080p"
}

第一帧/最后一帧插值：

{
  "prompt": "Smooth transition between these scenes",
  "firstFrame": {
    "source": "file_path",
    "filePath": "C:\\first.jpg"
  },
  "lastFrame": {
    "source": "file_path",
    "filePath": "C:\\last.jpg"
  }
}

参数：

• model - veo-3.1-generate-001 （质量）或 veo-3.1-fast-generate-001 （速度）
• durationSeconds -4、6或8
• aspectRatio - 16:9 或 9:16
• resolution - 720p 或 1080p
• generateAudio -包括同步音频（2倍成本）
• seed -为了再现性
• sampleCount -生成1-4个视频

2. get_video_job -检查状态

{
  "operationName": "operations/xyz"
}

完成后返回状态和视频URL。

3. upload_image -上传前参考

{
  "source": "file_path",
  "filePath": "C:\\style-ref.jpg"
}

退货 fileUri 有效期为48小时。跨代重复使用！

4. extend_video -扩展视频

{
  "videoFileUri": "files/abc123",
  "additionalSeconds": 7,
  "prompt": "Continue with the character walking into the sunset"
}

5. start_batch_video_generation -批量生成

{
  "jobs": [
    {"key": "scene1", "request": {"prompt": "..."}},
    {"key": "scene2", "request": {"prompt": "..."}}
  ],
  "concurrency": 3
}

6. estimate_veo_cost -成本估算

{
  "model": "veo-3.1-fast-generate-001",
  "durationSeconds": 8,
  "sampleCount": 1,
  "generateAudio": false
}

返回估计成本（美元）。

______________________________________________________________________

💰 定价

成本示例：

• 8秒视频（快速，无音频）： $0.80
• 8秒视频（质量，带音频）： $3.20
• 4s视频（快速，无音频）： $0.40

______________________________________________________________________

📊 限制和约束

______________________________________________________________________

💡 使用示例

简单文本到视频

Generate an 8-second video of a peaceful forest scene with morning mist

带有风格参考

Create a video of a tech startup office, using this image for style: C:\ref.jpg

帧插值

Generate a smooth transition between first.jpg and last.jpg, 8 seconds, cinematic camera movement

批量生成

Generate 5 different video variations of a product showcase with different angles

______________________________________________________________________

🔍 代币效率如何运作

❌ 朴素方法（Base64）

{
  "referenceImages": [{
    "base64": "iVBORw0KGgo..." // 500KB → ~50,000 tokens!
  }]
}

成本： 每次通话大量使用代币

✅ 令牌高效（此MCP）

{
  "referenceImages": [{
    "source": "url",
    "url": "" // ~20 tokens
  }]
}

发生了什么：

1. 服务器下载映像（无令牌）
2. 计算SHA-256哈希值
3. 检查缓存（48小时有效期）
4. 如果需要，上传到文件API（~1s）
5. 使用短 files/abc123 URI（~5个令牌）

节省： 代币减少97%以上！ 🎉

______________________________________________________________________

⏱️ 世代时间

注： 时间因提示复杂性和服务器负载而异。

______________________________________________________________________

🎨 最佳实践

1.从小处着手，扩大规模

Step 1: Generate 1 video at 720p
Step 2: If good, regenerate at 1080p
Step 3: Use batch for variations

2.使用快速模型进行测试

{
  "model": "veo-3.1-fast-generate-001",  // Testing
  "resolution": "720p"
}

切换到最终的质量模型：

{
  "model": "veo-3.1-generate-001",  // Final
  "resolution": "1080p"
}

3.预上传常用参考文献

// Step 1: Upload once
upload_image {"source": "file_path", "filePath": "brand-style.jpg"}
// Returns: files/xyz123

// Step 2: Reuse many times
{
  "referenceImages": [{"source": "file_uri", "fileUri": "files/xyz123"}]
}

4.利用批次进行变化

{
  "jobs": [
    {"key": "v1", "request": {"prompt": "Scene 1...", "seed": 1}},
    {"key": "v2", "request": {"prompt": "Scene 1...", "seed": 2}},
    {"key": "v3", "request": {"prompt": "Scene 1...", "seed": 3}}
  ]
}

5.监控成本

在大批量生产之前始终进行估算：

estimate_veo_cost {
  "model": "veo-3.1-fast-generate-001",
  "durationSeconds": 8,
  "sampleCount": 10
}
// Returns: $8.00 estimate

______________________________________________________________________

🎬 异步操作流程

Veo使用异步长时间运行操作：

1. start_video_generation
   ↓ Returns operationName immediately
   
2. get_video_job (poll every 10-30s)
   ↓ Returns {done: false, status: "RUNNING"}
   
3. get_video_job (after 60-120s)
   ↓ Returns {done: true, videos: [{videoUri: "..."}]}
   
4. Download video from videoUri

提示： 不要过于频繁地轮询（间隔\<10s）。

______________________________________________________________________

🆘 故障排除

“API未启用”（403）

1. 转到谷歌云控制台
2. 启用“生成语言API”
3. 启用计费
4. 等待5-10分钟进行传播

“超出费率限制”

• Veo允许约50个请求/分钟
• 使用批处理工具 concurrency: 3
• 增加请求之间的延迟

“包含引用的纵横比无效”

• 9:16可能不适用于参考图像
• 使用16:9作为参考模式
• 查看Veo 3.1文档以获取更新

“视频扩展失败”

• 只有Veo生成的视频可以扩展
• 无法扩展任意MP4
• 输入必须来自之前的Veo工作

世代久远

• 1080p比720p长
• 音频生成增加了时间
• 参考图像添加处理
• 帧插值速度最慢

______________________________________________________________________

📚 资源

• Veo 3.1文件
• 顶点AI定价
• 谷歌人工智能工作室
• 文件API指南

______________________________________________________________________

🎯 状态：生产就绪✅

• ✅ 已实施所有6个工具
• ✅ 令牌高效文件处理
• ✅ 异步操作支持
• ✅ 具有并发控制的批处理生成
• ✅ 成本估算
• ✅ 全面验证
• ✅ 错误处理
• ✅ 完整文档

准备好制作精彩视频了！ 🚀

______________________________________________________________________

内置于🎬 用于AI视频生成