VEO 3.1

VEO 3.1 MCP 服务

面向专业用途的 MCP 服务，支持 Google VEO 3.1 视频生成、异步任务模式、API 密钥轮换和多重下载回退。

快速安装

pip install veo-mcp-server
# or
uvx veo-mcp-server --help

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "veo": {
      "command": "uvx",
      "args": ["veo-mcp-server"],
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      }
    }
  }
}

变量	描述	默认值
GEMINI_API_KEY	Gemini API 密钥——所有生成操作均必需	--
GEMINI_API_KEY_BACKUP	用于在遇到 429 时自动轮换的备用密钥	--
VIDEO_OUTPUT_DIR	生成的视频的保存目录	~/veo-videos

功能

使用 Google 的 VEO 3.1 模型生成 AI 视频。支持文本生成视频、图像生成视频、视频延长和帧插值。采用异步任务模式，生成任务会立即在后台启动，并返回用于轮询的任务 ID。

工具（9 个）

工具	描述
veo_generate_video	根据文本提示词生成视频。支持分辨率（720p/1080p/4K）、宽高比（16:9/9:16）、时长（4/6/8s）、负向提示词、参考图像、种子控制和批量生成（1-4 个视频）。
veo_image_to_video	根据文本提示词为参考图像添加动画。支持分辨率、宽高比、参考图像和种子控制。
veo_interpolate_video	在首帧图像和末帧图像之间创建流畅的视频过渡。
veo_extend_video	将已有的 VEO 生成视频延长约 7 秒。仅支持 720p，总时长最长为 148 秒。源视频必须由之前的 VEO 生成（服务端会跟踪来源）。
veo_check_job	检查异步视频生成任务的状态。重复调用，直到状态为 'completed' 或 'failed'。
veo_list_jobs	列出所有视频生成任务及其当前状态。
veo_api_status	显示当前 API 密钥轮换状态——已配置的密钥、当前活动密钥和剩余密钥。
veo_pricing_info	显示 VEO 3.1 的生成视频每秒定价，涵盖所有分辨率下的标准模型和快速模型。
veo_show_output_stats	显示已生成视频以及活动/近期任务的统计信息。

配置

变量	描述	默认值
GEMINI_API_KEY	主要 Gemini API 密钥（必需）	--
GEMINI_API_KEY_BACKUP	用于在遇到 429 时自动轮换的备用密钥	--
VIDEO_OUTPUT_DIR	生成的视频的保存目录	~/veo-videos

架构

• 异步任务模式：所有生成工具都会立即返回任务 ID。后台线程负责处理耗时的 Google API 调用，因此每次 MCP 调用都会在 5 秒内返回。
• API 密钥轮换：遇到 429/RESOURCE_EXHAUSTED 时，会自动切换到备用密钥并重试。
• 三层下载回退：SDK 下载 -> URI 回退 -> 等待 ACTIVE 状态。可处理 Google Files API 的边缘情况。
• 预防性清理：每次生成前都会删除卡在 PROCESSING 状态的文件，以防止连续出现 500 错误。

模型

层级	模型 ID	用途
标准	veo-3.1-generate-preview	更高质量的输出
快速	veo-3.1-fast-generate-preview	更快的生成速度

许可证

MIT