Nano Banana — MCP-сервер для Claude Code: генерация и правка картинок
MCP-сервер, который даёт агенту генерацию и редактирование изображений через Google Gemini. Нужен, когда картинку надо получить прямо в ходе работы над кодом.
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Что делает 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 его придётся поднять.
Какие задачи решает
- сгенерировать картинку по описанию прямо из чата с агентом
- поправить существующее изображение без выхода из редактора
- собрать одну картинку из нескольких исходников
- сохранить результат в файл проекта, не затирая старый
- получить картинку в 2K или 4K для макета
Примеры запросов агенту
- Сгенерируй изображение: логотип для тёмной темы, сохрани в
assets/logo.png - Отредактируй
assets/hero.jpg— убери фон, результат положи вassets/hero-clean.png - Собери коллаж из
shot-1.pngиshot-2.pngв разрешении 2K
Как установить Nano Banana
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Nano Banana
Как установить Nano Banana в Claude Code?
Одной командой: claude mcp add mcp-server-nano-banana -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y @mindstone/mcp-server-nano-banana. Вместо <GEMINI_API_KEY> подставьте свой ключ Gemini.
Что делает Nano Banana?
Даёт агенту три инструмента: генерацию изображений по тексту, правку существующих картинок и сохранение ключа Gemini. Всё идёт через облачный API Google Gemini.
Что нужно для работы сервера?
Node.js 20+, npm и ключ GEMINI_API_KEY. Без ключа сервер не запустится.
