Nano-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.