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; запись файлов изображений на диск.
Настройка клиентов
{
"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.
{
"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.
OpenScreen
Запись экрана и видеоредактор: агенты записывают, обрезают, масштабируют, добавляют субтитры и экспортируют видео.
ffmpeg-skill
Локальные инструменты FFmpeg для видео и аудио.
davinci-resolve-mcp
Интеграция с DaVinci Resolve: монтаж, цветокоррекция, медиа и проекты.