nano-banana-mcp
Provides tools for generating, editing, and composing images using Google's Gemini 2.5 Flash Image model.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@nano-banana-mcp generate a watercolor image of a cat astronaut"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
nano-banana-mcp
Servidor MCP (Model Context Protocol) en TypeScript que expone Nano Banana —el modelo de imagen Gemini 2.5 Flash Image de Google— a Claude. Permite generar, editar y componer imágenes desde Claude Desktop, Claude Code o cualquier cliente MCP.
Capacidades (tools)
Tool | Descripción | Entradas |
| Texto → imagen |
|
| Imagen + texto → imagen (inpainting, estilo, retoques) |
|
| N imágenes + texto → imagen (fusión, composición, transferencia de estilo) |
|
Las imágenes de entrada (image / images) aceptan: ruta a archivo local,
data URL (data:image/png;base64,...) o base64 crudo.
Las imágenes de salida se devuelven inline en base64 en la respuesta del tool.
Related MCP server: NanoBanana MCP
Requisitos
Node.js >= 18
Una API key de Google AI Studio: https://aistudio.google.com/apikey
Instalación
npm install
npm run buildCopia .env.example a .env y coloca tu key:
cp .env.example .env
# edita .env -> GEMINI_API_KEY=...El
.enves solo para desarrollo local. Al conectarlo a un cliente MCP, la key se pasa por la variable de entorno del propio cliente (ver abajo).
Conectar a Claude
Claude Code (CLI)
claude mcp add nano-banana \
-e GEMINI_API_KEY=tu_api_key \
-- node /ruta/absoluta/nano-banana-mcp/dist/index.jsClaude Desktop
Edita claude_desktop_config.json:
{
"mcpServers": {
"nano-banana": {
"command": "node",
"args": ["/ruta/absoluta/nano-banana-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "tu_api_key"
}
}
}
}Reinicia el cliente y pídele, por ejemplo: "genera una imagen de un gato astronauta en acuarela".
Desarrollo
npm run dev # ejecuta con tsx (sin compilar)
npm run typecheck # verifica tipos
npm run build # compila a dist/Prueba rápida del protocolo (sin key, solo lista tools):
printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0.0.0"}}}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
| node dist/index.jsConfiguración
Variable | Requerida | Por defecto | Descripción |
| Sí | — | API key de Google AI Studio |
| No |
| Modelo de imagen a usar |
Ambientes
La configuración por ambiente (local / integración / QA / producción) está
documentada en docs/environments/. Las decisiones de
arquitectura en docs/architecture/.
Notas
En un servidor stdio,
stdoutestá reservado para el protocolo MCP; los logs de diagnóstico van astderr.Nunca comitees tu
.envni la API key (ya está en.gitignore).
Available Tools
3 toolscompose_imagesComponer imágenes (Nano Banana)A
Combina varias imágenes en una sola según un prompt (composición, fusión, transferencia de estilo, consistencia de personaje). Cada imagen puede ser ruta local, data URL o base64.
Inputs: images (required), prompt (required).
edit_imageEditar imagen (Nano Banana)A
Edita una imagen existente según un prompt (inpainting, cambio de estilo, retoques). La imagen puede ser una ruta a un archivo local, un data URL o base64 crudo.
Inputs: image (required), prompt (required).
generate_imageGenerar imagen (Nano Banana)A
Genera una imagen a partir de un prompt de texto usando Gemini 2.5 Flash Image (Nano Banana). Devuelve la imagen en base64.
Inputs: prompt (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool serves a distinct purpose: generate creates from scratch, edit modifies a single existing image, and compose blends multiple images. No overlap or ambiguity in their scopes.
All tool names follow a consistent verb_noun pattern: generate_image, edit_image, compose_images. The pattern is uniform and predictable.
Three tools is a well-scoped set for an image generation server focused on create, edit, and compose operations. Each tool is essential and none are redundant.
The surface covers the core image workflows (generation, editing, composition). Minor gaps like image analysis or format conversion exist, but these are not critical for the primary purpose.
Maintenance
Related MCP Connectors
MCP server for Qwen Image 3 AI image generation
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.
MCP server for Flux AI image generation
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides image generation using Google's Nano Banana Gemini models, with additional tools for background removal, upscaling, and format conversion via deterministic post-processing.1MIT
- AlicenseAqualityDmaintenanceMCP server that brings Gemini's image generation and editing capabilities to Claude Desktop, Claude Code, and Cursor. Supports Nano Banana 2 (Flash) and Nano Banana Pro models.7732 npm32MIT
- FlicenseNot gradedqualityDmaintenanceA remote MCP server that gives Claude the ability to generate and edit images with Google's nano banana (Gemini 2.5 Flash Image) model.-
- AlicenseNot gradedqualityCmaintenanceMCP server for Google's Nano Banana image generation models (Gemini). Generate and edit images via natural language.1MIT