Nano Banana MCP — расширение для генерации изображений (mcp-nanobanana)

Обзор

Nano Banana MCP — это мощное расширение Model Context Protocol для работы с изображениями в MCP-совместимых клиентах. Расширение предоставляет удобный интерфейс для текстового описания изображений и их преобразования, редактирования, восстановления и создания специализированного контента (иконки, паттерны, диаграммы, истории).

По умолчанию расширение использует модель google/gemini-2.5-flash-image и подключается к OpenRouter, но может быть настроено на работу с любым провайдером, который хостит эту модель. Все необходимые параметры настраиваются через переменные окружения.

Расширение обеспечивает интеллектуальное управление файлами с автоматическим созданием понятных имён файлов и предотвращением перезаписи существующих файлов.

Основные возможности

Ключевые функции

• 🎨 Генерация текст-в-изображение — создание качественных изображений из описательных промптов с поддержкой стилизации
• ✏️ Редактирование изображений — модификация существующих изображений с использованием естественного языка
• 🔧 Восстановление изображений — улучшение и восстановление старых или повреждённых фотографий
• 🎯 Генерация иконок — создание app-иконок, фавиконов и UI-элементов в разных размерах
• 🎨 Создание паттернов — генерация бесшовных паттернов и текстур для фонов
• 📖 Визуальные истории — создание последовательности изображений, рассказывающих историю или демонстрирующих процесс
• 📊 Технические диаграммы — генерация блок-схем, архитектурных диаграмм и мокапов
• 📁 Умное управление файлами — автоматическое создание понятных имён файлов и предотвращение дублирования
• 🌟 Естественный язык — гибкий интерфейс для открытых запросов без строгой структуры команд

Установка и настройка

Предварительные требования

• MCP-совместимый CLI (Gemini CLI, Codex CLI, Claude Code или аналогичный)
• Node.js 18+ и npm
• API-ключ от OpenRouter или другого провайдера с моделью google/gemini-2.5-flash-image

Установка через NPM (рекомендуется)

Для Gemini CLI:

gemini extensions install https://github.com/Aeven-AI/mcp-nanobanana

При установке вы будете приглашены ввести API-ключ.

Для Codex CLI:

codex mcp add nanobanana --env MODEL_API_KEY="YOUR_API_KEY_HERE" -- npx -y @aeven/nanobanana-mcp@latest

Для Opencode CLI:

Отредактируйте файл opencode.jsonc (через opencode config edit):

{
  "mcp": {
    "nanobanana": {
      "type": "local",
      "command": ["npx", "-y", "@aeven/nanobanana-mcp@latest"],
      "enabled": true,
      "environment": {
        "MODEL_API_KEY": "{env:MODEL_API_KEY}"
      }
    }
  }
}

Для Claude Code:

Перейдите в Settings → Model Context Protocol → Add Server. Установите команду npx с аргументами -y и @aeven/nanobanana-mcp@latest. Добавьте переменную окружения MODEL_API_KEY.

Конфигурация API-ключа

Переменная окружения MODEL_API_KEY требуется для аутентификации. Её можно установить:

• Автоматически при установке (Gemini CLI)
• Через флаг --env в команде установки (Codex CLI)
• В профиле shell (~/.zshrc, ~/.bashrc, ~/.profile): export MODEL_API_KEY="YOUR_API_KEY_HERE"

Переменные окружения провайдера

• MODEL_BASE_URL — альтернативный endpoint провайдера (по умолчанию: https://openrouter.ai/api/v1)
• MODEL_ID — ID модели (по умолчанию: google/gemini-2.5-flash-image)
• MODEL_REFERER / MODEL_TITLE — заголовки аналитики
• MODEL_GENERATE_PATH — путь endpoint генерации (по умолчанию: /responses)

Использование

Доступные команды

После активации расширения доступны следующие команды:

• /generate — генерация одного или нескольких изображений со стилизацией
• /edit — редактирование существующего изображения
• /restore — восстановление и улучшение фотографий
• /icon — создание иконок и UI-элементов в разных размерах
• /pattern — генерация бесшовных паттернов и текстур
• /story — создание последовательности изображений
• /diagram — генерация технических диаграмм и блок-схем
• /nanobanana — интерфейс на естественном языке

Примеры базовых команд

# Генерация одного изображения
/generate "акварельная живопись лиса в снежном лесу"

# Несколько вариаций
/generate "закат над горами" --count=3 --preview

# Редактирование
/edit my_photo.png "добавить солнечные очки человеку"

# Восстановление
/restore old_family_photo.jpg "убрать царапины и улучшить чёткость"

# Генерация иконок
/icon "логотип кофейной чашки" --sizes="64,128,256" --type="app-icon"

# Создание паттернов
/pattern "геометрические треугольники" --type="seamless" --style="geometric"

# Визуальная история
/story "семя растёт в дерево" --steps=4 --type="process"

# Диаграмма
/diagram "процесс входа пользователя" --type="flowchart" --style="professional"

# Естественный язык
/nanobanana создай логотип для моего стартапа
/nanobanana мне нужны 5 версий иллюстрации кошки в разных стилях искусства

Продвинутые возможности

Опции генерации

Команда /generate поддерживает:

• --count=N — количество вариаций (1-8, по умолчанию 1)
• --styles="style1,style2" — художественные стили (photorealistic, watercolor, oil-painting, sketch, pixel-art, anime, vintage, modern, abstract, minimalist)
• --variations="var1,var2" — типы вариаций (lighting, angle, color-palette, composition, mood, season, time-of-day)
• --format=grid|separate — формат вывода
• --seed=123 — seed для воспроизводимых вариаций
• --preview — автоматически открыть изображения

Генерация иконок

Опции /icon:

• --sizes="16,32,64" — размеры иконок в пикселях
• --type="app-icon|favicon|ui-element" — тип иконки
• --style="flat|skeuomorphic|minimal|modern" — визуальный стиль
• --background="transparent|white|black|color" — фон
• --corners="rounded|sharp" — скруглённые или острые углы

Паттерны и текстуры

Опции /pattern:

• --size="256x256" — размер плитки паттерна
• --type="seamless|texture|wallpaper" — тип паттерна
• --style="geometric|organic|abstract|floral|tech" — стиль
• --density="sparse|medium|dense" — плотность элементов
• --colors="mono|duotone|colorful" — цветовая схема

Визуальные истории

Опции /story:

• --steps=N — количество изображений (2-8, по умолчанию 4)
• --type="story|process|tutorial|timeline" — тип последовательности
• --style="consistent|evolving" — согласованность визуальной стилизации
• --layout="separate|grid|comic" — расположение кадров
• --transition="smooth|dramatic|fade" — стиль переходов

Технические диаграммы

Опции /diagram:

• --type="flowchart|architecture|network|database|wireframe|mindmap|sequence" — тип диаграммы
• --style="professional|clean|hand-drawn|technical" — визуальный стиль
• --layout="horizontal|vertical|hierarchical|circular" — ориентация
• --complexity="simple|detailed|comprehensive" — уровень детальности
• --colors="mono|accent|categorical" — цветовая схема

Управление файлами

• Интеллектуальные имена: «sunset over mountains» → sunset_over_mountains.png
• Предотвращение дубликатов: автоматические счётчики (sunset_over_mountains_1.png, sunset_over_mountains_2.png)
• Поиск файлов: текущая директория, ./images/, ./input/, ./nanobanana-output/, ~/Downloads/, ~/Desktop/
• Выходная директория: ./nanobanana-output/ (создаётся автоматически)

Часто задаваемые вопросы

Полезные ссылки

• GitHub репозиторий: Aeven-AI/mcp-nanobanana
• OpenRouter документация: openrouter.ai/docs
• Model Context Protocol: modelcontextprotocol.io
• Лицензия: Apache License 2.0
• Политика безопасности: SECURITY.md в репозитории