
Nano Banana MCP: генерация и правка картинок в Claude Code и Cursor
Даёт агенту генерировать и править картинки моделью Nano Banana из Gemini API: по тексту, по фото, по нескольким референсам, с нужным соотношением сторон. Файлы сохраняются в папку проекта.
Пакет npm под Nano Banana 2: разрешение 1K, 2K или 4K, режимы размышления, до 4 вариантов за вызов и выдача только пути к файлу, чтобы не забивать контекст.
Как подключить
Что сделать до подключения
Node.js с командой npx
Ключ Gemini API из Google AI Studio
GEMINI_API_KEYaistudio.google.com/apikey → создать ключ
NANO_BANANA_MODELнеобязательно: другая модель вместо gemini-3.1-flash-image-preview
NANO_BANANA_OUTPUT_DIRнеобязательно: папка для картинок, по умолчанию ./generated_imgs
Конфиг для вашего клиента
Впишите ключи, и они встанут во все конфиги ниже. Конфиг собирается в браузере.
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --env 'GEMINI_API_KEY=<ключ Gemini API>' --transport stdio nano-banana \
-- npx -y nano-banana-2-mcpПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.nano-banana]
command = "npx"
args = ["-y", "nano-banana-2-mcp"]
[mcp_servers.nano-banana.env]
GEMINI_API_KEY = "<ключ Gemini API>"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"nano-banana": {
"command": "npx",
"args": ["-y", "nano-banana-2-mcp"],
"env": {
"GEMINI_API_KEY": "<ключ Gemini API>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"nano-banana": {
"type": "stdio",
"command": "npx",
"args": ["-y", "nano-banana-2-mcp"],
"env": {
"GEMINI_API_KEY": "<ключ Gemini API>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"nano-banana": {
"command": "npx",
"args": ["-y", "nano-banana-2-mcp"],
"env": {
"GEMINI_API_KEY": "<ключ Gemini API>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"nano-banana": {
"command": "npx",
"args": ["-y", "nano-banana-2-mcp"],
"env": {
"GEMINI_API_KEY": "<ключ Gemini API>"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"nano-banana": {
"type": "local",
"command": ["npx", "-y", "nano-banana-2-mcp"],
"environment": {
"GEMINI_API_KEY": "<ключ Gemini API>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"nano-banana": {
"command": "npx",
"args": ["-y", "nano-banana-2-mcp"],
"env": {
"GEMINI_API_KEY": "<ключ Gemini API>"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"nano-banana": {
"command": "npx",
"args": ["-y", "nano-banana-2-mcp"],
"env": {
"GEMINI_API_KEY": "<ключ Gemini API>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
generate_imageсоздаёт картинку по текстуedit_imageправит картинку по запросуcontinue_editingдорабатывает последнюю картинкуget_configuration_statusпоказывает ключ, модель и настройкиget_last_image_infoпоказывает путь и размер картинкиФорк ConechoAI/Nano-Banana-MCP с выбором модели через GEMINI_MODEL, по умолчанию gemini-3.1-flash-image-preview; ставится из исходников, ключ можно задать прямо в сессии.
Как подключить
Что сделать до подключения
Node.js; склонировать репозиторий и выполнить npm install
Ключ Gemini API из Google AI Studio
GEMINI_API_KEYaistudio.google.com/apikey → Create API key
GEMINI_MODELнеобязательно: gemini-3.1-flash-image-preview, gemini-3-pro-image-preview или gemini-2.5-flash-image
Конфиг для вашего клиента
Впишите ключи, и они встанут во все конфиги ниже. Конфиг собирается в браузере.
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --env 'GEMINI_API_KEY=<ключ Gemini API>' --env GEMINI_MODEL=gemini-3.1-flash-image-preview --transport stdio nanobanana-mcp \
-- node /path/to/nanobanana-mcp/dist/index.jsПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.nanobanana-mcp]
command = "node"
args = ["/path/to/nanobanana-mcp/dist/index.js"]
[mcp_servers.nanobanana-mcp.env]
GEMINI_API_KEY = "<ключ Gemini API>"
GEMINI_MODEL = "gemini-3.1-flash-image-preview"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"nanobanana-mcp": {
"command": "node",
"args": ["/path/to/nanobanana-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "<ключ Gemini API>",
"GEMINI_MODEL": "gemini-3.1-flash-image-preview"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"nanobanana-mcp": {
"type": "stdio",
"command": "node",
"args": ["/path/to/nanobanana-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "<ключ Gemini API>",
"GEMINI_MODEL": "gemini-3.1-flash-image-preview"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"nanobanana-mcp": {
"command": "node",
"args": ["/path/to/nanobanana-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "<ключ Gemini API>",
"GEMINI_MODEL": "gemini-3.1-flash-image-preview"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"nanobanana-mcp": {
"command": "node",
"args": ["/path/to/nanobanana-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "<ключ Gemini API>",
"GEMINI_MODEL": "gemini-3.1-flash-image-preview"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"nanobanana-mcp": {
"type": "local",
"command": ["node", "/path/to/nanobanana-mcp/dist/index.js"],
"environment": {
"GEMINI_API_KEY": "<ключ Gemini API>",
"GEMINI_MODEL": "gemini-3.1-flash-image-preview"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"nanobanana-mcp": {
"command": "node",
"args": ["/path/to/nanobanana-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "<ключ Gemini API>",
"GEMINI_MODEL": "gemini-3.1-flash-image-preview"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"nanobanana-mcp": {
"command": "node",
"args": ["/path/to/nanobanana-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "<ключ Gemini API>",
"GEMINI_MODEL": "gemini-3.1-flash-image-preview"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
generate_imageсоздаёт картинку по текстуedit_imageправит файл картинки по запросуcontinue_editingдорабатывает последнюю картинкуget_last_image_infoпоказывает путь и размер картинкиconfigure_gemini_tokenзадаёт ключ во время работыget_configuration_statusпроверяет, задан ли ключОдин гибкий инструмент generate_image с референсами; в клиентах с MCP Apps картинка открывается во встроенном просмотрщике прямо в чате.
Как подключить
Что сделать до подключения
Node.js; склонировать репозиторий, выполнить npm install и npm run build
Ключ Google AI Studio
GOOGLE_API_KEYaistudio.google.com/apikey → создать ключ
Конфиг для вашего клиента
Впишите ключи, и они встанут во все конфиги ниже. Конфиг собирается в браузере.
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --env 'GOOGLE_API_KEY=<ключ Google AI Studio>' --transport stdio nano-banana-mcp \
-- node /path/to/nano-banana-mcp/dist/index.jsПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.nano-banana-mcp]
command = "node"
args = ["/path/to/nano-banana-mcp/dist/index.js"]
[mcp_servers.nano-banana-mcp.env]
GOOGLE_API_KEY = "<ключ Google AI Studio>"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"nano-banana-mcp": {
"command": "node",
"args": ["/path/to/nano-banana-mcp/dist/index.js"],
"env": {
"GOOGLE_API_KEY": "<ключ Google AI Studio>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"nano-banana-mcp": {
"type": "stdio",
"command": "node",
"args": ["/path/to/nano-banana-mcp/dist/index.js"],
"env": {
"GOOGLE_API_KEY": "<ключ Google AI Studio>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"nano-banana-mcp": {
"command": "node",
"args": ["/path/to/nano-banana-mcp/dist/index.js"],
"env": {
"GOOGLE_API_KEY": "<ключ Google AI Studio>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"nano-banana-mcp": {
"command": "node",
"args": ["/path/to/nano-banana-mcp/dist/index.js"],
"env": {
"GOOGLE_API_KEY": "<ключ Google AI Studio>"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"nano-banana-mcp": {
"type": "local",
"command": ["node", "/path/to/nano-banana-mcp/dist/index.js"],
"environment": {
"GOOGLE_API_KEY": "<ключ Google AI Studio>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"nano-banana-mcp": {
"command": "node",
"args": ["/path/to/nano-banana-mcp/dist/index.js"],
"env": {
"GOOGLE_API_KEY": "<ключ Google AI Studio>"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"nano-banana-mcp": {
"command": "node",
"args": ["/path/to/nano-banana-mcp/dist/index.js"],
"env": {
"GOOGLE_API_KEY": "<ключ Google AI Studio>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
generate_imageсоздаёт или правит картинку по референсамЧто попросить агента
Для каких задач
Ограничения
Картинки генерирует Gemini API по вашему ключу; charlesdove977 приводит цены около $0.039–0.134 за картинку в зависимости от модели
Проекты небольшие: 40, 21 и 17 звёзд; pierceboggan/nano-banana-mcp не обновлялся с марта 2026 года
Модель gemini-2.5-flash-image-preview отключена в январе 2026 года: пакеты, где она зашита, перестали работать
Картинки в base64 разрастают контекст Claude Code; nano-banana-2-mcp умеет отдавать только путь к файлу
Если не работает
Старый пакет Nano Banana перестал генерировать картинки
Claude Code упирается в размер контекста после нескольких картинок
Какую реализацию выбрать
| Реализация | Кто делает | Звёзды | Запуск | Ключ | Инструменты | Обновлён |
|---|---|---|---|---|---|---|
| nano-banana-2-mcp | Dave Remy | 21 | локально | токен | 5 | 4 августа 2026 |
| Nano Banana MCP | Charles Dove | 40 | локально | токен | 6 | 23 октября 2026 |
| nano-banana-mcp | Pierce Boggan | 17 | локально | токен | 1 | 2 марта 2026 |