nanobanana-mcp-server — MCP-сервер для Claude Code: генерация картинок
MCP-сервер, который даёт агенту генерацию и правку изображений через модели Gemini. Пригодится, когда нужны картинки прямо в сессии кодинга.
claude mcp add --env GEMINI_API_KEY=<GEMINI_API_KEY> --env IMAGE_OUTPUT_DIR=<IMAGE_OUTPUT_DIR> --transport stdio nanobanana-mcp-server -- uvx nanobanana-mcp-serverЧто делает nanobanana-mcp-server
Сервер подключается к Claude, Codex, Cursor, GitHub Copilot, Windsurf, Cline и Zed и отдаёт агенту три инструмента: generate_image, edit_image и upload_file. Запросы уходят в модели Gemini, причём выбор между ними сервер делает сам по тексту промпта. По умолчанию работает gemini-3.1-flash-image-preview — это Nano Banana 2, который даёт разрешение до 3840px. Для сложных композиций остаётся Gemini 3 Pro Image, а Gemini 2.5 Flash Image оставлен как старая быстрая модель.
Есть управление пропорциями кадра (1:1, 16:9, 9:16, 21:9 и другие), готовые шаблоны промптов для съёмки, дизайна и правки, а также работа с файлами через Gemini Files API. Шаблоны и метаданные файлов видны агенту как MCP-ресурсы. Без ключа GEMINI_API_KEY сервер не заработает — это первое, что нужно подготовить.
Аутентификация настраивается переменной NANOBANANA_AUTH_METHOD. Вариант api_key берёт ключ Gemini, vertex_ai идёт через Google Cloud Application Default Credentials и требует GCP_PROJECT_ID и GCP_REGION; для Gemini 3 Pro Image и NB2 регион ставят global, а us-central1 годится только для старой 2.5 Flash Image. Режим auto сначала пробует ключ, потом Vertex AI. Для запуска из исходников нужен Python 3.11+.
Какие задачи решает
- сгенерировать иллюстрацию по текстовому описанию прямо в сессии
- поправить готовую картинку, не выходя из редактора
- задать пропорции кадра под конкретный макет
- взять готовый шаблон промпта вместо сочинения с нуля
- загрузить файл в Gemini Files API и сослаться на него
Примеры запросов агенту
- Сгенерируй картинку с котом в шляпе, пропорции 16:9
- Отредактируй
cover.png— убери фон - Загрузи
logo.pngи используй его как референс
Как установить nanobanana-mcp-server
Командой платформы
claude mcp add --env GEMINI_API_KEY=<GEMINI_API_KEY> --env IMAGE_OUTPUT_DIR=<IMAGE_OUTPUT_DIR> --transport stdio nanobanana-mcp-server -- uvx nanobanana-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nanobanana-mcp-server <команда>
Командой платформы
codex mcp add nanobanana-mcp-server --env GEMINI_API_KEY=<GEMINI_API_KEY> --env IMAGE_OUTPUT_DIR=<IMAGE_OUTPUT_DIR> -- uvx nanobanana-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nanobanana-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"nanobanana-mcp-server": {
"command": "uvx",
"args": [
"nanobanana-mcp-server"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"IMAGE_OUTPUT_DIR": "<IMAGE_OUTPUT_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nanobanana-mcp-server <команда>
Файл настроек
{
"servers": {
"nanobanana-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"nanobanana-mcp-server"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"IMAGE_OUTPUT_DIR": "<IMAGE_OUTPUT_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nanobanana-mcp-server <команда>
Командой платформы
gemini mcp add -e GEMINI_API_KEY=<GEMINI_API_KEY> -e IMAGE_OUTPUT_DIR=<IMAGE_OUTPUT_DIR> nanobanana-mcp-server uvx nanobanana-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nanobanana-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Похожие
Рядом в теме «ИИ и ML»
Все MCP-серверы по теме «ИИ и ML» →Вопросы о nanobanana-mcp-server
Как установить nanobanana-mcp-server в Claude Code?
Выполните claude mcp add nanobanana-mcp-server -e GEMINI_API_KEY=<GEMINI_API_KEY> -- uvx nanobanana-mcp-server. Второй вариант добавляет ещё и каталог вывода: `claude mcp add --env GEMINI_API_KEY=<GEMINI_API_KEY> --env IMAGE_OUTPUT_DIR=<IMAGE_OUTPUT_DIR> --transport stdio nanobanana-mcp-server -- uvx nanobanana-mcp-server`.
Что делает nanobanana-mcp-server?
Даёт агенту инструменты generate_image, edit_image и upload_file, которые обращаются к моделям Gemini. Модель под запрос сервер подбирает сам.
Что нужно для работы сервера?
Ключ GEMINI_API_KEY либо доступ к Vertex AI с GCP_PROJECT_ID и GCP_REGION. Способ задаётся переменной NANOBANANA_AUTH_METHOD.
