# Nano Banana

MCP-сервер, который даёт агенту генерацию и редактирование изображений через Google Gemini. Нужен, когда картинку надо получить прямо в ходе работы над кодом.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Автор: mindstone
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/mindstone/mcp-servers/tree/HEAD/connectors/nano-banana
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/nano-banana

## Что делает

Сервер поднимает три инструмента. `nano_banana_generate` рисует изображение по текстовому описанию, `nano_banana_edit` правит уже существующее, а `configure_nano_banana_api_key` сохраняет ключ Gemini. Работает через облачный API, локально ничего не считает.

В `nano_banana_edit` можно передать до 14 исходных картинок — путём в рабочей папке или ссылкой `https://`. Каждый источник ограничен 20MB, удалённые адреса проверяются на SSRF: только HTTPS, без userinfo, приватные и loopback-хосты отклоняются. Форматы — PNG, JPEG и WebP, GIF вернёт ошибку `UNSUPPORTED_IMAGE_FORMAT`. Сохранение не перезаписывает файлы: если по `save_path` что-то уже лежит, придёт `SAVE_EXISTS`.

Без `GEMINI_API_KEY` сервер не заработает, ключ обязателен. Нужны Node.js 20+ и npm. Разрешение задаётся параметром `image_size` — `"1K"`, `"2K"` или `"4K"`, по умолчанию `"1K"`; выше 1K отдают только модели Gemini 3, а `gemini-2.5-flash-image` всегда рисует около 1K и явный `image_size` отвергает. Таймаут запроса к Gemini по умолчанию `180000` мс — на медленной генерации через `gemini-3-pro-image-preview` его придётся поднять.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `GEMINI_API_KEY`, `MCP_WORKSPACE_PATH`, `NANO_BANANA_GEMINI_TIMEOUT_MS`, `NANO_BANANA_BRIDGE_TIMEOUT_MS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env GEMINI_API_KEY=<GEMINI_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --env NANO_BANANA_GEMINI_TIMEOUT_MS=<NANO_BANANA_GEMINI_TIMEOUT_MS> --env NANO_BANANA_BRIDGE_TIMEOUT_MS=<NANO_BANANA_BRIDGE_TIMEOUT_MS> --transport stdio nano-banana -- npx -y @mindstone/mcp-server-nano-banana
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add nano-banana --env GEMINI_API_KEY=<GEMINI_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --env NANO_BANANA_GEMINI_TIMEOUT_MS=<NANO_BANANA_GEMINI_TIMEOUT_MS> --env NANO_BANANA_BRIDGE_TIMEOUT_MS=<NANO_BANANA_BRIDGE_TIMEOUT_MS> -- npx -y @mindstone/mcp-server-nano-banana
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nano-banana": {
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-nano-banana"
            ],
            "env": {
                "GEMINI_API_KEY": "<GEMINI_API_KEY>",
                "MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>",
                "NANO_BANANA_GEMINI_TIMEOUT_MS": "<NANO_BANANA_GEMINI_TIMEOUT_MS>",
                "NANO_BANANA_BRIDGE_TIMEOUT_MS": "<NANO_BANANA_BRIDGE_TIMEOUT_MS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "nano-banana": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-nano-banana"
            ],
            "env": {
                "GEMINI_API_KEY": "<GEMINI_API_KEY>",
                "MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>",
                "NANO_BANANA_GEMINI_TIMEOUT_MS": "<NANO_BANANA_GEMINI_TIMEOUT_MS>",
                "NANO_BANANA_BRIDGE_TIMEOUT_MS": "<NANO_BANANA_BRIDGE_TIMEOUT_MS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e GEMINI_API_KEY=<GEMINI_API_KEY> -e MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> -e NANO_BANANA_GEMINI_TIMEOUT_MS=<NANO_BANANA_GEMINI_TIMEOUT_MS> -e NANO_BANANA_BRIDGE_TIMEOUT_MS=<NANO_BANANA_BRIDGE_TIMEOUT_MS> nano-banana npx -y @mindstone/mcp-server-nano-banana
```
Вместо <…> подставьте свои значения

## Когда брать
- сгенерировать картинку по описанию прямо из чата с агентом
- поправить существующее изображение без выхода из редактора
- собрать одну картинку из нескольких исходников
- сохранить результат в файл проекта, не затирая старый
- получить картинку в 2K или 4K для макета

## Примеры запросов агенту
- Сгенерируй изображение: логотип для тёмной темы, сохрани в `assets/logo.png`
- Отредактируй `assets/hero.jpg` — убери фон, результат положи в `assets/hero-clean.png`
- Собери коллаж из `shot-1.png` и `shot-2.png` в разрешении 2K

## Похожие
- [Nano Banana by Ace Data Cloud](https://affpapa.org/nevibecode/mcp/nano-banana-by-ace-data-cloud.md) — MCP-сервер · ★ 7
- [nano-banana-pro-openrouter](https://affpapa.org/nevibecode/skills/nano-banana-pro-openrouter.md) — скилл · 9910 установок
- [nano-banana-pro](https://affpapa.org/nevibecode/skills/nano-banana-pro.md) — скилл · 3200 установок
- [muapi-nano-banana](https://affpapa.org/nevibecode/skills/muapi-nano-banana.md) — скилл · 2800 установок
- [nano-banana-2](https://affpapa.org/nevibecode/skills/intellectronica-nano-banana-2.md) — скилл · 869 установок
- [nano-banana-prompts](https://affpapa.org/nevibecode/skills/nano-banana-prompts.md) — скилл · 600 установок

Из того же набора: [mindstone/mcp-servers](https://affpapa.org/nevibecode/by/mindstone/mcp-servers.md) — 24 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md