VEO 3.1

io.github.u2n4由 GitHub 账号 u2n4 发布v1.1.2更新于 Oct 24, 2026

4K video generation via Google VEO 3.1: text-to-video, image-to-video, video extension

已验证STDIO仅桌面媒体与设计AI 与机器学习

概览

AI 生成的概览

本地 MCP 服务器，让助手通过 Google VEO 3.1 生成 4K AI 视频：文生视频、图生视频、帧插值与视频延长。

可以做什么
根据文本提示生成视频，可设置分辨率、宽高比、时长、负面提示、参考图、随机种子和批量数量；也可用提示词让参考图动起来，或在首尾帧之间做平滑过渡。将已有的 VEO 生成视频延长约 7 秒。查询、列出并跟踪异步生成任务，因为生成在后台启动并返回任务 ID。查看 API 密钥轮换状态、VEO 每秒价格和输出统计。
适用场景
适合希望助手通过 Google VEO 3.1 制作短视频片段或让静态图片动起来，并在同一对话中管理生成任务和文件的场景。
运行要求
以 Python 包形式在本地运行（pip 或 uvx）。需要 GEMINI_API_KEY 中的 Gemini API 密钥；可选的 GEMINI_API_KEY_BACKUP 用于触发限流时轮换。VIDEO_OUTPUT_DIR 指定视频保存目录（默认 ~/veo-videos）。需要访问 Google API 的网络连接。
安装前请注意
生成会调用 Google 付费的 VEO 3.1 API，使用会产生费用；服务器提供价格查询工具。Gemini API 密钥以环境变量传入，可访问该账户的配额。视频会写入本地输出目录，且服务器在每次生成前会删除卡在处理中的文件。

安装

在 SourceWeft 中

  1. 打开 控制台中的 VEO 3.1，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

VEO 3.1 MCP Server

Professional-grade MCP server for Google VEO 3.1 video generation with async job pattern, API key rotation, and multi-fallback download.

Quick Install

bash
pip install veo-mcp-server# oruvx veo-mcp-server --help

Claude Desktop (claude_desktop_config.json):

json
{  "mcpServers": {    "veo": {      "command": "uvx",      "args": ["veo-mcp-server"],      "env": {        "GEMINI_API_KEY": "your_key_here"      }    }  }}
VariableDescriptionDefault
GEMINI_API_KEYGemini API key — required for all generation--
GEMINI_API_KEY_BACKUPBackup key for automatic rotation on 429--
VIDEO_OUTPUT_DIRDirectory where generated videos are saved~/veo-videos

What It Does

Generates AI videos using Google's VEO 3.1 model. Supports text-to-video, image-to-video, video extension, and frame interpolation. Uses an async job pattern where generation starts immediately in the background and returns a job ID for polling.

Tools (9)

ToolDescription
veo_generate_videoGenerate video from a text prompt. Supports resolution (720p/1080p/4K), aspect ratio (16:9/9:16), duration (4/6/8s), negative prompts, reference images, seed control, and batch generation (1-4 videos).
veo_image_to_videoAnimate a reference image with a text prompt. Supports resolution, aspect ratio, reference images, and seed control.
veo_interpolate_videoCreate a smooth video transition between a first frame and a last frame image.
veo_extend_videoExtend an existing VEO-generated video by ~7 seconds. 720p only, max 148 seconds total. Source must be from a previous VEO generation (tracks provenance server-side).
veo_check_jobCheck the status of an async video generation job. Call repeatedly until status is 'completed' or 'failed'.
veo_list_jobsList all video generation jobs and their current status.
veo_api_statusShow current API key rotation status — keys configured, active key, keys remaining.
veo_pricing_infoShow VEO 3.1 pricing per second of generated video for both standard and fast models at all resolutions.
veo_show_output_statsDisplay statistics about generated videos and active/recent jobs.

Configuration

VariableDescriptionDefault
GEMINI_API_KEYPrimary Gemini API key (required)--
GEMINI_API_KEY_BACKUPBackup key for automatic rotation on 429--
VIDEO_OUTPUT_DIRDirectory where generated videos are saved~/veo-videos

Architecture

  • Async Job Pattern: All generation tools return a job ID instantly. Background threads handle the long-running Google API calls, so each MCP call returns in under 5 seconds.
  • API Key Rotation: On 429/RESOURCE_EXHAUSTED, automatically switches to the backup key and retries.
  • 3-Layer Download Fallback: SDK download -> URI fallback -> Wait-for-ACTIVE state. Handles Google's Files API edge cases.
  • Preventive Cleanup: Deletes stuck PROCESSING files before each generation to prevent cascading 500 errors.

Models

TierModel IDUse Case
Standardveo-3.1-generate-previewHigher quality output
Fastveo-3.1-fast-generate-previewQuicker generation

License

MIT

来源：servers/veo/README.md，提交 1b8fc5a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.1.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分