veo-mcp-server

Was ist das?

Gemini Media MCP ist ein umfassendes Toolkit, das die leistungsstärksten KI-Mediengenerierungsmodelle von Google in jeden MCP-kompatiblen KI-Assistenten integriert. Generieren Sie 4K-Videos mit VEO 3.1, erstellen Sie beeindruckende Bilder mit NanoBanana Pro 2 und entwerfen Sie professionelle Prompts mit integrierten Skills – alles aus einem einzigen Repository.

Was ist enthalten

MCP-Server

Claude Code Skills (Plugin-Marktplatz)

Installieren Sie Skills über Claude Code:

/plugin marketplace add u2n4/gemini-media-mcp

Schnellstart

Dieses Repo hostet zwei unabhängige MCP-Server. Installieren Sie, was Sie benötigen – oder beides. Jeder Server wird separat auf PyPI veröffentlicht.

Option A — uvx (keine Installation erforderlich, empfohlen)

Fügen Sie einen Block zu Ihrer MCP-Client-Konfiguration (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf) hinzu, indem Sie den entsprechenden Server-Block unten verwenden (siehe Abschnitte VEO-Server / NanoBanana-Server).

Option B — Klonen + editierbare Installation

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-Server

uvx (keine Installation erforderlich):

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

pip install veo-mcp-server

NanoBanana-Server

uvx (keine Installation erforderlich):

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

VEO-Server

KI-Videogenerierung, unterstützt durch Google VEO 3.1. Verwendet ein asynchrones Job-Muster, bei dem die Generierung im Hintergrund startet und eine Job-ID für das Polling zurückgibt – keine Timeouts.

Tools

VEO-Konfiguration

VEO-Modelle

NanoBanana-Server

KI-Bildgenerierung, unterstützt durch NanoBanana Pro 2. Unterstützt Pro- (maximale Qualität) und Flash-Modelle (schnell) mit 4K-Standardauflösung.

Tools

Modelle

Prompting-Skills

VEO Prompting-Skill

7-Ebenen-Prompt-Engineering-System für VEO 3.1:

1. Kinematografie (Kamera, Shot-Typ, Objektiv, Winkel)

2. Subjekt (Charaktere, Objekte, Materialhinweise)

3. Aktion (kraftbasierte Verben, Zeitstempel-Beats)

4. Umgebung (Tageszeit, Wetter, Tiefenebenen)

5. Beleuchtung & Stimmung (physische Lichtquellen, Farbtemperatur)

6. Audio-Design (Dialog, SFX, Ambient, Musik)

7. Technische Kontrollen (negative Prompts, Stil-Anker, Filmmaterial)

NanoBanana Prompting-Skill

7-Ebenen-Prompt-Engineering-System für NanoBanana Pro 2:

1. Stil & Art Direction (visuelle DNA)

2. Szenenbeschreibung (Umgebung, Atmosphäre)

3. Hauptsubjekt (Hero-Element mit extremer Spezifität)

4. Kamera & Objektiv (echte Kameraspezifikationen für Realismus)

5. Beleuchtung (natürlich, Studio, Farbtemperatur)

6. Textur, Material & Farbe (taktiles Detail)

7. Negative Prompts (Qualitätswächter)

Architektur

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

Mitwirken

Siehe CONTRIBUTING.md.

Lizenz

MIT -- siehe LICENSE.

Credits

• NanoBanana MCP-Server: inspiriert von der Namenskonvention "nano-banana", die in der gesamten MCP-Community verwendet wird. Dies ist eine unabhängige Implementierung.

• VEO 3.1 von Google DeepMind

Support

Wenn Sie dies nützlich finden, geben Sie diesem Repository bitte einen Stern!

Hergestellt mit ❤️ in der Ostprovinz von Saudi-Arabien.