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 创建精美图像，并利用内置技巧编写专业提示词——所有这些功能都集成在同一个仓库中。

包含内容

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 层提示词工程系统：

电影摄影（摄像机、镜头类型、角度）
主体（角色、物体、材质提示）
动作（基于力的动词、时间戳节拍）
环境（一天中的时间、天气、深度层）
灯光与氛围（物理光源、色温）
音频设计（对话、音效、环境音、音乐）
技术控制（负面提示、风格锚点、胶片类型）

NanoBanana 提示词技巧

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

风格与艺术指导（视觉 DNA）
场景描述（环境、氛围）
主体（具有极高特异性的核心元素）
摄像机与镜头（用于真实感的真实摄像机规格）
灯光（自然光、摄影棚光、色温）
纹理、材质与颜色（触觉细节）
负面提示（质量防护）

架构

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 提供

支持

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

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

veo-mcp-server

这是什么？

包含内容

MCP 服务器

Claude Code 技能（插件市场）

快速开始

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

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

VEO 服务器

NanoBanana 服务器

VEO 服务器

工具

VEO 配置

VEO 模型

NanoBanana 服务器

工具

模型

提示词技巧

VEO 提示词技巧

NanoBanana 提示词技巧

架构

贡献指南

许可证

致谢

支持

Maintenance

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API

这是什么？

包含内容

MCP 服务器

Claude Code 技能（插件市场）

快速开始

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

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

VEO 服务器

NanoBanana 服务器

VEO 服务器

工具

VEO 配置

VEO 模型

NanoBanana 服务器

工具

模型

提示词技巧

VEO 提示词技巧

NanoBanana 提示词技巧

架构

贡献指南

许可证

致谢

支持

Maintenance

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API

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