nanobanana-mcp-server

nanobanana-mcp-server — MCP-сервер сообщества (автор — zhongweili). Генерация и редактирование изображений моделью Nano Banana. Ставится через uvx или через pip. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
zhongweili
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
python

Уровень риска: high

Запросы к Gemini API / Vertex AI по вашему ключу расходуют квоту и могут тарифицироваться Google; промпты и изображения уходят в Google; запись файлов изображений на диск.

Настройка клиентов

codex
{
    "code": "[mcp_servers.nanobanana]\ncommand = \"uvx\"\nargs = [\"nanobanana-mcp-server@latest\"]\n\n[mcp_servers.nanobanana.env]\nGEMINI_API_KEY = \"your-gemini-api-key-here\"",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Nano Banana MCP Server генерирует и редактирует изображения через модели Google Gemini и сам выбирает подходящую модель под запрос. Ассистент вызывает инструменты generate_image, edit_image и upload_file прямо в рабочей сессии.

Возможности по README:

  • три модели Gemini: Nano Banana 2 (gemini-3.1-flash-image-preview, модель по умолчанию — до 4K, 2–4 секунды на изображение), Gemini 3 Pro Image (максимальная глубина рассуждений, уровни thinking LOW/HIGH) и устаревшая Gemini 2.5 Flash Image (до 1024 пикселей, для быстрых черновиков);
  • автоматический выбор модели: Pro включается по словам вроде «4K», «professional», при высоком уровне рассуждений или нескольких входных изображениях, в остальных случаях используется NB2;
  • привязка к Google Поиску для фактически точных изображений, согласованность до 5 персонажей и 14 объектов в сцене, аккуратная отрисовка текста;
  • соотношение сторон (1:1, 16:9, 9:16, 21:9 и другие) и путь сохранения (output_path, иначе IMAGE_OUTPUT_DIR или ~/nanobanana-images);
  • шаблоны промптов для фотографии, дизайна и редактирования;
  • файлы через Gemini Files API, ресурсы MCP для шаблонов и метаданных файлов.

Кому подойдёт

  • Дизайнерам, маркетологам и разработчикам, которым нужны изображения для продуктов, баннеров и интерфейсов прямо из ассистента.
  • Тем, кто уже работает с Gemini API или Vertex AI в Google Cloud.

Похожие серверы — в категории ИИ-сервисы.

Установка

Нужен API-ключ Google Gemini. Сервер запускается через uvx или устанавливается через pip:

uvx nanobanana-mcp-server@latest

Способ авторизации задаёт NANOBANANA_AUTH_METHOD: api_key (переменная GEMINI_API_KEY), vertex_ai (учётные данные Google Cloud по умолчанию, плюс GCP_PROJECT_ID и GCP_REGION) или auto. Для Vertex AI нужно включить API aiplatform.googleapis.com и выдать роль roles/aiplatform.user.

Подключение к клиентам

Конфиги приведены дословно из README; подставьте свой ключ. Подробнее — в инструкции как подключить MCP.

claude_desktop_config.json
{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["nanobanana-mcp-server@latest"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    }
  }
}

Файл Claude Desktop находится в ~/Library/Application Support/Claude/ (macOS) или %APPDATA%\Claude\ (Windows). Для Codex подойдёт и проектный .codex/config.toml. В README есть также конфиги для Continue.dev, Open WebUI и вариант с Vertex AI.

Проверка

Попросите ассистента сгенерировать простое изображение, например «кот на подоконнике», и проверьте, что файл появился в ~/nanobanana-images или в папке из IMAGE_OUTPUT_DIR.

Примеры задач

Сгенерируй фото товара на белом фоне в 4K, соотношение сторон 1:1, сохрани в ./assets/products/.
Отредактируй этот баннер: замени надпись на «Распродажа -30%» и сделай фон темнее.

Риски

  • Квоты и расходы Google. Каждое изображение — запрос к Gemini API или Vertex AI по вашему ключу или проекту Google Cloud. Модель Pro и разрешение 4K выбираются автоматически по словам в запросе. Следите за квотами и расходами в консоли Google.
  • Передача данных. Промпты, входные изображения и загруженные файлы отправляются в Google.
  • Запись файлов. Изображения сохраняются по пути из output_path или в папку по умолчанию; относительный путь отсчитывается от рабочей папки процесса сервера.
  • Ключ. GEMINI_API_KEY в конфиге клиента даёт доступ к вашему проекту Gemini — не публикуйте его. Для Codex учтите, что синтаксическая ошибка в общем config.toml ломает и CLI, и расширение.

Частые вопросы

Какая модель используется по умолчанию?

Nano Banana 2 (Gemini 3.1 Flash Image). Pro подключается автоматически для сложных запросов или явно через model_tier="pro".

Куда сохраняются изображения?

По пути из output_path, иначе в IMAGE_OUTPUT_DIR или ~/nanobanana-images.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

FunASR

Локальная расшифровка аудио моделями FunASR и SenseVoice.

Риск: medium Лицензия: MIT ★ 20 999

OpenScreen

Запись экрана и видеоредактор: агенты записывают, обрезают, масштабируют, добавляют субтитры и экспортируют видео.

Риск: medium Лицензия: MIT ★ 7 025

ffmpeg-skill

Локальные инструменты FFmpeg для видео и аудио.

Риск: medium Лицензия: MIT ★ 4 730

davinci-resolve-mcp

Интеграция с DaVinci Resolve: монтаж, цветокоррекция, медиа и проекты.

Риск: medium Лицензия: MIT ★ 4 003

Источники