Skip to main content
Glama
deenesjakoruzh
u2n4

veo-mcp-server

by u2n4
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

CLI

安装检查

版本检查

veo-mcp-server

veo-mcp-server --help

veo-mcp-server --version

nanobanana-imagen-mcp

nanobanana-imagen-mcp --help

nanobanana-imagen-mcp --version

这是什么？

Gemini Media MCP 是一个综合工具包，可将 Google 最强大的 AI 媒体生成模型引入任何兼容 MCP 的 AI 助手。使用 VEO 3.1 生成 4K 视频，使用 NanoBanana Pro 2 创建精美图像，并利用内置技巧编写专业提示词——所有这些功能都集成在同一个仓库中。

Related MCP server: media-mcp

包含内容

MCP 服务器

服务器

描述

工具

VEO 3.1

AI 视频生成（文生视频、图生视频、扩展、插值）

9 个工具

NanoBanana

使用 NanoBanana Pro 2 进行 AI 图像生成（Pro + Flash 模型）

4 个工具

Claude Code 技能（插件市场）

技能

描述

VEO Prompting

用于电影级 VEO 3.1 视频的 7 层提示词工程

NanoBanana Prompting

用于照片级真实感 NanoBanana Pro 2 图像的 7 层提示词工程

通过 Claude Code 安装技能：

/plugin marketplace add u2n4/gemini-media-mcp

快速开始

本仓库托管了两个独立的 MCP 服务器。安装您需要的任何一个，或者两个都安装。每个服务器都分别发布到 PyPI。

选项 A — uvx（无需安装，推荐）

使用下方的相应服务器块，将块添加到您的 MCP 客户端配置中（Claude Desktop、Claude Code、Cursor、VS Code、Windsurf）（请参阅 VEO 服务器 / NanoBanana 服务器部分）。

选项 B — 克隆 + 可编辑安装

git clone https://github.com/u2n4/gemini-media-mcp.git
cd gemini-media-mcp

# Create a virtual environment (uv pip install requires one — or pass --system)
uv venv
source .venv/bin/activate     # macOS / Linux
# .venv\Scripts\activate     # Windows PowerShell

# Install one or both sub-packages
uv pip install -e servers/veo
uv pip install -e servers/nanobanana

VEO 服务器

uvx（无需安装）：

{
  "mcpServers": {
    "veo": {
      "command": "uvx",
      "args": ["veo-mcp-server"],
      "env": {
        "GEMINI_API_KEY": "your_key",
        "VIDEO_OUTPUT_DIR": "./videos"
      }
    }
  }
}

Claude Code：

claude mcp add veo -s user -e GEMINI_API_KEY=your_key -- uvx veo-mcp-server

pip 安装：

pip install veo-mcp-server

NanoBanana 服务器

uvx（无需安装）：

{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["nanobanana-imagen-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_key"
      }
    }
  }
}

Claude Code：

claude mcp add nanobanana -s user -e GEMINI_API_KEY=your_key -- uvx nanobanana-imagen-mcp

pip 安装：

pip install nanobanana-imagen-mcp

VEO 服务器

由 Google VEO 3.1 提供支持的 AI 视频生成。使用异步作业模式，生成在后台启动并返回作业 ID 以供轮询——无超时限制。

工具

工具

描述

veo_generate_video

从文本提示生成视频。支持 720p/1080p/4K、16:9 或 9:16、4/6/8 秒时长、负面提示、参考图像、种子控制和批量生成（1-4 个视频）。

veo_image_to_video

使用运动提示为参考图像制作动画。

veo_interpolate_video

在两帧之间创建平滑过渡（第一帧 + 最后一帧）。

veo_extend_video

将现有的 VEO 视频延长约 7 秒。仅限 720p，总时长最多 148 秒。

veo_check_job

检查异步作业状态。每 15-20 秒调用一次，直到完成或失败。

veo_list_jobs

列出所有生成作业及其当前状态。

veo_api_status

检查 API 密钥状态——已配置的密钥、活动密钥、剩余密钥。

veo_pricing_info

显示所有分辨率下标准模型和快速模型的每秒定价。

veo_show_output_stats

显示生成统计信息——视频数量、总大小、文件详情、作业状态。

VEO 配置

变量

描述

默认值

GEMINI_API_KEY

主 API 密钥（必需）

--

GEMINI_API_KEY_BACKUP

用于自动轮换的备份密钥

--

VIDEO_OUTPUT_DIR

视频输出目录

~/veo-videos

VEO 模型

层级

模型

最佳用途

标准

veo-3.1-generate-preview

更高质量的输出

快速

veo-3.1-fast-generate-preview

更快的生成速度

NanoBanana 服务器

由 NanoBanana Pro 2 提供支持的 AI 图像生成。支持 Pro（最高质量）和 Flash（快速）模型，默认分辨率为 4K。

工具

工具

描述

generate_image

使用 NanoBanana Pro 2（Pro 或 Flash）生成图像。支持纵横比、分辨率（最高 4K）、负面提示、思维水平、接地和参考图像。

upload_file

上传用于编辑或调节的参考图像。

show_output_stats

显示生成统计信息——图像数量、总大小、文件详情。

maintenance

服务器维护和清理——清除缓存、删除临时文件。

模型

模型

引擎

最佳用途

Pro

Gemini 3 Pro Image

最高质量，复杂场景

Flash

Gemini 3.1 Flash Image

快速生成，简单场景

提示词技巧

VEO 提示词技巧

适用于 VEO 3.1 的 7 层提示词工程系统：

  1. 电影摄影（摄像机、镜头类型、角度）

  2. 主体（角色、物体、材质提示）

  3. 动作（基于力的动词、时间戳节拍）

  4. 环境（一天中的时间、天气、深度层）

  5. 灯光与氛围（物理光源、色温）

  6. 音频设计（对话、音效、环境音、音乐）

  7. 技术控制（负面提示、风格锚点、胶片类型）

NanoBanana 提示词技巧

适用于 NanoBanana Pro 2 的 7 层提示词工程系统：

  1. 风格与艺术指导（视觉 DNA）

  2. 场景描述（环境、氛围）

  3. 主体（具有极高特异性的核心元素）

  4. 摄像机与镜头（用于真实感的真实摄像机规格）

  5. 灯光（自然光、摄影棚光、色温）

  6. 纹理、材质与颜色（触觉细节）

  7. 负面提示（质量防护）

架构

gemini-media-mcp/
├── servers/
│   ├── veo/                       # VEO 3.1 MCP Server (PyPI: veo-mcp-server)
│   │   ├── pyproject.toml
│   │   ├── requirements.txt
│   │   └── src/
│   │       └── veo_mcp_server/
│   │           ├── __init__.py
│   │           ├── __main__.py
│   │           └── server.py
│   └── nanobanana/                # NanoBanana MCP Server (PyPI: nanobanana-imagen-mcp)
│       ├── pyproject.toml
│       ├── requirements.txt
│       └── nanobanana_mcp_server/ # Package
├── skills/
│   ├── veo-prompting/             # VEO prompting skill
│   │   └── SKILL.md
│   └── nanobanana-prompting/      # NanoBanana prompting skill
│       └── SKILL.md
├── plugins/                       # Claude Code Plugin Marketplace
│   ├── veo-prompting/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   └── skills/
│   │       └── veo-prompting/
│   │           └── SKILL.md
│   └── nanobanana-prompting/
│       ├── .claude-plugin/
│       │   └── plugin.json
│       └── skills/
│           └── nanobanana-prompting/
│               └── SKILL.md
├── .claude-plugin/
│   └── marketplace.json
├── .env.example
├── .gitignore
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── llms.txt
└── llms-install.md

贡献指南

请参阅 CONTRIBUTING.md。

许可证

MIT —— 请参阅 LICENSE。

致谢

  • NanoBanana MCP 服务器：灵感来源于 MCP 社区中使用的 nano-banana 命名约定。这是一个独立的实现。

  • VEO 3.1 由 Google DeepMind 提供

支持

如果您觉得这很有用，请给此仓库加星！

在沙特阿拉伯东部省份用心制作 ❤️。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

Appeared in Searches