veo-mcp-server

veo-mcp-server is replaced by omni-mcp-server 2.0.0; update client commands and tool names (see migration notes).

What is This?

Gemini Media MCP is a comprehensive toolkit that brings Google's most powerful AI media generation models into any MCP-compatible AI assistant. Generate videos with Gemini Omni, create stunning images with NanoBanana Pro 2, and craft professional prompts with built-in skills -- all from a single repository.

Related MCP server: media-mcp

What's Included

MCP Servers

Claude Code Skills (Plugin Marketplace)

Install skills via Claude Code:

/plugin marketplace add u2n4/gemini-media-mcp

Quick Start

This repo hosts two independent MCP servers. Install whichever you need — or both. Each server publishes to PyPI separately.

Option A — uvx (zero-install, recommended)

Add a block to your MCP client config (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf) using the appropriate server block below (see Omni Server / NanoBanana Server sections).

Option B — clone + editable install

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

# Each server needs its own environment (different MCP major versions).
uv sync --project servers/omni
uv sync --project servers/nanobanana

uv run --project servers/omni omni-mcp-server --help
uv run --project servers/nanobanana nanobanana-imagen-mcp --help

Omni Server

uvx (zero-install):

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

Claude Code:

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

pip install:

pip install omni-mcp-server

NanoBanana Server

uvx (zero-install):

{
  "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 install:

pip install nanobanana-imagen-mcp

Omni Server

AI video generation powered by gemini-omni-1.2-flash through the Interactions API. Uses an async job pattern where generation starts in the background and returns a job ID for polling -- no timeouts.

Tools

Omni Configuration

Omni Models

NanoBanana Server

AI image generation powered by NanoBanana Pro 2. Supports Pro (maximum quality) and Flash (fast) models with default 4K resolution.

Tools

Models

Prompting Skills

Omni Prompting Skill

Prompt planning guidance for Gemini Omni:

1. Cinematography (camera, shot type, lens, angles)

2. Subject (characters, objects, material cues)

3. Action (force-based verbs, timestamp beats)

4. Environment (time of day, weather, depth layers)

5. Lighting & Mood (physical light sources, color temperature)

6. Continuity (reference images, first/last frames and extension)

7. Tool Controls (duration, resolution, aspect ratio and output path)

NanoBanana Prompting Skill

7-layer prompt engineering system for NanoBanana Pro 2:

1. Style & Art Direction (visual DNA)

2. Scene Description (environment, atmosphere)

3. Main Subject (hero element with extreme specificity)

4. Camera & Lens (real camera specs for realism)

5. Lighting (natural, studio, color temperature)

6. Texture, Material & Color (tactile detail)

7. Negative Prompts (quality guards)

Architecture

gemini-media-mcp/
├── servers/
│   ├── omni/                       # Gemini Omni Video MCP Server (PyPI: omni-mcp-server)
│   │   ├── pyproject.toml
│   │   ├── requirements.txt
│   │   └── src/
│   │       └── omni_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/
│   ├── omni-prompting/             # Omni prompting skill
│   │   └── SKILL.md
│   └── nanobanana-prompting/      # NanoBanana prompting skill
│       └── SKILL.md
├── plugins/                       # Claude Code Plugin Marketplace
│   ├── omni-prompting/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   └── skills/
│   │       └── omni-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

See CONTRIBUTING.md.

License

MIT -- see LICENSE.

Credits

• NanoBanana MCP Server: inspired by the nano-banana naming convention used across the MCP community. This is an independent implementation.

• Gemini Omni by Google DeepMind

Support

If you find this useful, please star this repository!

Made with ❤️ in the Eastern Province of Saudi Arabia.

Refresh verification — 2026-11-05

Gemini paths were tested only with a fake client and never live. Both API keys were unset for all test runs; tests block real SDK clients and HTTP requests. Omni extension/interpolation and reference-image request shapes were checked against Google's Omni docs, full docs and installed SDK source. Legacy video seed, batch and negative-prompt shapes remain unconfirmed and unavailable. NanoBanana starts and lists tools without credentials; Gemini-dependent tools return a clear error naming GEMINI_API_KEY when no key is configured. gemini-3.1-flash-image is also listed as Stable; this server's Flash route uses the documented preview replacement gemini-nano-banana-2.1.

Omni uses mcp>=1.0.0,<2; NanoBanana uses fastmcp>=4,<5. Install them in separate environments or use their independent uvx commands. Both cap google-genai>=2.5.0,<3. See each server's CHANGELOG for migration details.