veo-mcp-server

Что это такое?

Gemini Media MCP — это комплексный набор инструментов, который позволяет использовать самые мощные модели генерации медиаконтента от Google в любом ИИ-ассистенте, совместимом с MCP. Генерируйте 4K-видео с помощью VEO 3.1, создавайте потрясающие изображения с помощью NanoBanana Pro 2 и составляйте профессиональные промпты с помощью встроенных навыков — и все это из одного репозитория.

Что входит в комплект

MCP-серверы

Навыки Claude Code (Маркетплейс плагинов)

Установите навыки через Claude Code:

/plugin marketplace add u2n4/gemini-media-mcp

Быстрый старт

Этот репозиторий содержит два независимых MCP-сервера. Установите тот, который вам нужен, или оба сразу. Каждый сервер публикуется в PyPI отдельно.

Вариант А — uvx (без установки, рекомендуется)

Добавьте блок в конфигурацию вашего MCP-клиента (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf), используя соответствующий блок сервера ниже (см. разделы VEO Server / NanoBanana Server).

Вариант Б — клонирование + редактируемая установка

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

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

pip install nanobanana-imagen-mcp

Сервер VEO

Генерация видео с помощью ИИ на базе Google VEO 3.1. Использует асинхронную модель заданий, где генерация запускается в фоновом режиме и возвращает ID задания для опроса — никаких тайм-аутов.

Инструменты

Конфигурация VEO

Модели VEO

Сервер NanoBanana

Генерация изображений с помощью ИИ на базе NanoBanana Pro 2. Поддерживает модели Pro (максимальное качество) и Flash (быстрая) с разрешением 4K по умолчанию.

Инструменты

Модели

Навыки промптинга

Навык VEO Prompting

7-уровневая система промпт-инжиниринга для VEO 3.1:

1. Кинематография (камера, тип кадра, объектив, углы)

2. Объект (персонажи, объекты, указания на материалы)

3. Действие (глаголы, основанные на силе, временные метки)

4. Окружение (время суток, погода, слои глубины)

5. Освещение и настроение (физические источники света, цветовая температура)

6. Аудиодизайн (диалоги, спецэффекты, эмбиент, музыка)

7. Технический контроль (негативные промпты, стилевые якоря, типы кинопленки)

Навык NanoBanana Prompting

7-уровневая система промпт-инжиниринга для NanoBanana Pro 2:

1. Стиль и арт-дирекшн (визуальная ДНК)

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 Server: вдохновлен соглашением об именовании nano-banana, используемым в сообществе MCP. Это независимая реализация.

• VEO 3.1 от Google DeepMind

Поддержка

Если вам это полезно, пожалуйста, поставьте звезду этому репозиторию!

Сделано с ❤️ в Восточной провинции Саудовской Аравии.