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 分