About nano-banana-mcp
nano-banana-mcp is an MCP server for generating and editing images with Google Gemini. It supports several Nano Banana model variants and provides tools for iterative editing and image status checks.
Key features
- 01Generate images from text prompts
- 02Edit images with optional reference images
- 03Continue editing the most recent image
- 04Choose among supported Gemini models
- 05Check configuration and last-image details
Use cases
- 01Create an image from a text description
- 02Modify an existing image using references
- 03Iteratively refine the latest generated image
MCP support
The server exposes image generation, editing, configuration, and image-information tools to MCP clients such as Claude Code and Cursor. A Gemini API key is configured for access.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @fjacquet/nano-banana-mcpGEMINI_API_KEYSecretGemini API key from Google AI Studio. Optional: it can also be set later with the configure_gemini_token tool.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
6Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| apiKey | string | Yes | Your Gemini API key from Google AI Studio |
Details
From the project READMENano-Banana MCP Server
An MCP server for AI image generation and editing using Google Gemini. Works with Claude Code, Cursor, and other MCP clients.
Models supported:
| Brand name | Model ID | Notes |
|---|---|---|
| Nano Banana 2.1 | gemini-nano-banana-2.1 | Default — pro quality at Flash speed |
| Nano Banana Pro | gemini-3-pro-image | Highest quality, advanced reasoning |
| Nano Banana 2 | gemini-3.1-flash-image | Previous default |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | Fastest and cheapest — 1K output only |
| Nano Banana | gemini-2.5-flash-image | Legacy — shut down by Google on 2027-03-15 |
Quick Start
-
Get a Gemini API key from Google AI Studio
-
Add to your MCP client config (Claude Code example):
{
"mcpServers": {
"nano-banana": {
"command": "npx",
"args": ["-y", "github:fjacquet/Nano-Banana-MCP"],
"env": {
"GEMINI_API_KEY": "your-key-here"
}
}
}
}
See docs/configuration.md for Cursor and other MCP clients.
- Use the tools:
Generate an image of a sunset over mountains
Edit this image to add some birds in the sky
Continue editing to make it more dramatic
Tools
| Tool | Description |
|---|---|
generate_image | Create new images from text prompts |
edit_image | Modify existing images with optional reference images |
continue_editing | Iteratively edit the last image |
get_last_image_info | Get info about the last image |
configure_gemini_token | Set API key |
get_configuration_status | Check configuration |
All generation/editing tools accept an optional model parameter to choose between the two models.
See docs/tools.md for full API reference, docs/configuration.md for setup details, and docs/workflows.md for usage patterns.
Development
npm install
npm run dev # Run with tsx
npm run build # Compile TypeScript
npm test # Run tests
npm run lint # Lint
npm run typecheck # Type-check
Requires Node.js >= 18.0.0.
License
MIT — see LICENSE.
Fork of ConechoAI/Nano-Banana-MCP.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.