Nano Banana MCP Server
MCP-сервер генерации и правки картинок моделями Gemini: сам выбирает модель под запрос, рисует до 4K в нужном формате кадра
- 402 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запросы уходят в Gemini API и расходуют квоту или деньги вашего аккаунта Google
- Ключ API хранится в конфигурации клиента, а сервер записывает файлы в папку вывода
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/nano-banana-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запросы уходят в Gemini API и расходуют квоту или деньги вашего аккаунта Google
- Ключ API хранится в конфигурации клиента, а сервер записывает файлы в папку вывода
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Nano Banana MCP Server подключает к агенту генерацию изображений на моделях Gemini. Агент вызывает инструменты generate_image, edit_image и upload_file: создает картинку по описанию, правит готовую и загружает файлы через Gemini Files API. Результат сервер сохраняет на диск, по умолчанию в папку ~/nanobanana-images. Моделей три. Nano Banana 2 на базе Gemini 3.1 Flash Image работает по умолчанию: разрешение до 4K, привязка к поиску Google, до пяти персонажей и 14 объектов в одной сцене, аккуратный текст на картинке. Gemini 3 Pro Image берет сложные композиции и принимает настраиваемую глубину рассуждений. Gemini 2.5 Flash Image остается для быстрых черновиков до 1024 пикселей. В режиме auto сервер выбирает модель по тексту запроса: слова вроде «4K» или «professional» ведут к Pro, а «quick» и «draft» — к Nano Banana 2. Среди параметров — соотношение сторон от 1:1 до 21:9, разрешение, thinking_level и число картинок n за один вызов. Для фотографии, дизайна и редактирования в сервере есть шаблоны промптов: агент видит их как MCP-ресурсы.
Для кого. Для разработчиков и дизайнеров, которым нужны картинки для сайтов, интерфейсов и соцсетей прямо в сессии Claude Code, Cursor или Codex.
Подходит, если
- Нужна обложка или превью точно в заданном формате: aspect_ratio принимает 16:9, 9:16, 21:9, 1:1, 4:5 и другие
- На картинке должна быть читаемая надпись, например афиша или карточка товара: Nano Banana 2 умеет точно размещать текст
- Нужна серия вариантов за один вызов: параметр n создает несколько картинок и нумерует файлы
- Проект работает на Google Cloud, и ключи API неудобны: сервер входит через Vertex AI и учетные данные приложения
- Готовую картинку надо поправить по текстовому описанию через edit_image
Не подходит, если
- Агент работает без интернета или в закрытом контуре: все модели вызываются через Gemini API
- Нужен другой поставщик, например Midjourney или OpenAI: сервер умеет только модели Gemini
- Нужно видео или анимация: сервер создает и правит только изображения
Пример запроса к агенту
Сделай обложку для YouTube 16:9 с надписью «Запуск 1 ноября» на темном фоне и сохрани ее в папку assetsMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
GEMINI_API_KEYобязательная, секрет- Ключ Gemini API для входа по ключу; при входе через Vertex AI не нужен
NANOBANANA_AUTH_METHOD- Способ входа: api_key, vertex_ai или auto
NANOBANANA_MODEL- Модель по умолчанию: flash, nb2, pro или auto
IMAGE_OUTPUT_DIR- Папка для картинок, когда output_path не задан
Ограничения
Нужен ключ Gemini API (GEMINI_API_KEY) либо доступ к Vertex AI в проекте Google Cloud с ролью roles/aiplatform.user. Для Gemini 3 Pro Image и Nano Banana 2 в Vertex AI регион должен быть global, значение us-central1 подходит только для Gemini 2.5 Flash Image.
Относительный output_path отсчитывается от рабочей папки процесса сервера. Переменная IMAGE_OUTPUT_DIR действует, только если output_path не задан. Python 3.11 нужен лишь для разработки, для запуска через uvx хватает установленного uv.
Доступность Gemini API из России при подготовке карточки не проверялась.
Как отключить. Удалите запись nanobanana из mcpServers в конфигурации Claude Desktop, Cursor или Continue, а в Codex — раздел mcp_servers.nanobanana из config.toml. Ключ Gemini при необходимости отзовите в аккаунте Google. Сохраненные картинки останутся в ~/nanobanana-images.
Частые вопросы
Как подключить Nano Banana MCP к Claude Code?
Добавьте сервер в конфигурацию: command uvx, args nanobanana-mcp-server@latest, в env передайте GEMINI_API_KEY. Те же поля подходят для Cursor и Continue.dev. В Codex запись идет в раздел mcp_servers файла config.toml, добавить ее можно и командой codex mcp add.
Чем Nano Banana 2 отличается от Pro в этом сервере?
Nano Banana 2 стоит по умолчанию и справляется за 2–4 секунды на картинку при разрешении до 4K. Pro тратит 5–8 секунд, зато глубже рассуждает над сложной сценой и поддерживает thinking_level со значениями LOW и HIGH. Принудительно выбрать модель можно параметром model_tier со значениями nb2, pro или flash.
Как войти через Google Cloud без API-ключа?
Задайте NANOBANANA_AUTH_METHOD=vertex_ai, GCP_PROJECT_ID и GCP_REGION=global. В проекте должен быть включен Vertex AI API, а сервисному аккаунту выдана роль roles/aiplatform.user. Значение auto берет ключ, если он есть, и переходит к Vertex AI, если ключа нет.
Куда сервер сохраняет картинки?
Приоритет такой: параметр output_path, затем переменная IMAGE_OUTPUT_DIR, затем папка ~/nanobanana-images. Путь с косой чертой в конце считается каталогом, сервер сам создаст его и придумает имя файла. При n больше единицы файлы получают номера _2, _3 и так далее.
Работает ли сервер с Gemini CLI и Open WebUI?
Да, для обоих даны примеры конфигурации. Gemini CLI и другие клиенты общего вида запускают сервер командой uvx nanobanana-mcp-server@latest, а ключ берут из переменной окружения GEMINI_API_KEY. В Open WebUI команда и env задаются в разделе mcp_servers.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыКонсольная утилита и скилл для Claude Code: картинки через Gemini от 512 до 4K, правка по образцам, прозрачные ассеты
Nano Banana Pro Prompts Recommend
AI Image Prompt Recommender
Скилл подбирает готовые промпты для генерации картинок из большой библиотеки, показывает примеры изображений и собирает промпт под ваш текст
MCP-сервер для генерации изображений и видео из агента: несколько моделей, большая библиотека промптов и параллельные задачи
Скилл генерации, правки и ревью изображений в Claude Code через модели Google Gemini, с планом и подтверждением перед каждым платным запросом
Более 1400 популярных промптов для NanoBanana и GPT Image из постов в X с рейтингом по лайкам и системный промпт, который улучшает короткую идею
Локальный MCP-сервер для правки и разбора изображений: агент обрезает кадры, находит объекты и читает текст с фото
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Nano Banana MCP Server (эта запись) | нет | API-ключ | 402 | |
| Nano Banana 2 Skill | нет | 416 | CLI и скилл для картинок Gemini без MCP-сервера | |
| MCP Kandinsky | да | API-ключ | 6 | MCP-сервер генерации через Kandinsky от Сбера |
Коротко о README
Для Claude Desktop, Claude Code, Cursor, Codex, Continue.dev, Open WebUI и Gemini CLI даны готовые фрагменты конфигурации. Два способа входа, ключ API и Vertex AI, описаны отдельно, рядом таблица выбора модели с примерами вызовов. В разделе неполадок разобраны отсутствующий ключ, неудачный старт сервера и права на папку с картинками.