Mcp Nano Banana

mcp-nano-banana

MCP server for AI-powered image generation using Google Gemini Nano Banana models. Generate, edit, and combine images from text prompts — directly from your AI coding assistant.

[npm version] [license]

Features

• Text-to-image generation — Create images from natural language descriptions
• Image editing — Upload images and modify them with text instructions
• Multi-image combination — Mix up to 14 reference images into one composite
• Resolution control — Generate at 512px, 1K, 2K, or 4K resolution
• 13+ aspect ratios — From square (1:1) to ultra-wide (21:9) and tall (1:8)
• Auto-fallback — Pro model falls back to Flash on rate limits (429/403/402)
• File output — Save to specific paths or return inline base64
• Favicon generation — Generate complete favicon packages with one command
• Multi-format output — PNG, JPEG, and WebP support

Quick Start

Prerequisites

1. Get a Gemini API key from Google AI Studio
2. Enable billing on your Google Cloud project — image generation requires a paid tier (~$0.04-0.05/image for NB2 at standard resolution)

Installation

npm install -g mcp-nano-banana

Set your API key:

export GEMINI_API_KEY=your-api-key

For MCP Registry publication metadata, the registry name is io.github.codeFi/mcp-nano-banana.

MCP Configuration

Codex

codex mcp add nano-banana --env GEMINI_API_KEY=your-api-key -- npx -y mcp-nano-banana@latest

Or add manually to ~/.codex/config.toml:

[mcp_servers.nano-banana]command = "npx"args = ["-y", "mcp-nano-banana@latest"]
[mcp_servers.nano-banana.env]GEMINI_API_KEY = "your-api-key"

Qwen Code

Add to ~/.qwen/settings.json:

{  "mcpServers": {    "nano-banana": {      "command": "npx",      "args": ["-y", "mcp-nano-banana@latest"],      "env": {        "GEMINI_API_KEY": "your-api-key"      }    }  }}

Claude Code

claude mcp add nano-banana -e GEMINI_API_KEY=your-api-key -- npx -y mcp-nano-banana@latest

Or add manually to ~/.claude/claude_desktop_config.json:

{  "mcpServers": {    "nano-banana": {      "command": "npx",      "args": ["-y", "mcp-nano-banana@latest"],      "env": {        "GEMINI_API_KEY": "your-api-key"      }    }  }}

Other MCP Clients

For CLIs and desktop clients that use the standard mcpServers JSON format, register:

{  "mcpServers": {    "nano-banana": {      "command": "npx",      "args": ["-y", "mcp-nano-banana@latest"],      "env": {        "GEMINI_API_KEY": "your-api-key"      }    }  }}

Local / Development Build

git clone https://github.com/codeFi/mcp-nano-banana.gitcd mcp-nano-banananpm installnpm run build

Then register with your MCP client:

{  "mcpServers": {    "nano-banana": {      "command": "node",      "args": ["/path/to/mcp-nano-banana/dist/index.js"],      "env": {        "GEMINI_API_KEY": "your-api-key"      }    }  }}

Models

The server defaults to Nano Banana Pro for best quality and automatically falls back to Flash on rate limits.

Available Parameters

Resolution

Default: "1K"

Aspect Ratio

Tools

generate_image

Generate or edit images from text prompts.

Examples

Generate from text:

{  "prompt": "A sunset over mountains with dramatic lighting",  "aspectRatio": "16:9",  "resolution": "2K",  "outputPath": "/Users/currentUser/Desktop/sunset.png"}

Edit an existing image:

{  "prompt": "Change the background to a coffee shop interior",  "imagePaths": ["/Users/currentUser/photo.jpg"],  "outputPath": "/Users/currentUser/edited.png"}

Combine multiple images:

{  "prompt": "Put these glasses on this person's face",  "imagePaths": ["/path/to/face.jpg", "/path/to/glasses.jpg"],  "outputPath": "/path/to/result.png"}

High-res wallpaper:

{  "prompt": "A futuristic cityscape at night with neon lights and rain",  "aspectRatio": "16:9",  "resolution": "4K",  "outputPath": "/path/to/wallpaper.png"}

generate_favicons

Generate a complete favicon package from a prompt or existing image.

Example

{  "prompt": "A minimalist banana icon with a soft gradient",  "outputDir": "/path/to/favicon",  "outputPath": "/path/to/favicon.zip",  "appName": "MyBrand",  "shortName": "Brand",  "themeColor": "#1a1a2e",  "backgroundColor": "#ffffff"}

Generated files:

• favicon.ico — Multi-size icon (16/32/48px)
• favicon-16x16.png — Browser tabs
• favicon-32x32.png — Higher-res tabs
• apple-touch-icon.png — iOS home screen
• android-chrome-192x192.png — Android
• android-chrome-512x512.png — Android HD
• site.webmanifest — PWA manifest

HTML snippet (included in response):

<link rel="icon" href="/favicon.ico" sizes="any"><link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png"><link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png"><link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png"><link rel="manifest" href="/site.webmanifest">

Pricing

Image generation requires a paid Google AI Studio account. Approximate costs:

You only pay for what you generate — no monthly minimum.

Supported Image Formats

Input (reference images): png, jpg, jpeg, webp, gif Output: png, jpeg, webp

Development

# Build TypeScriptnpm run build
# Watch modenpm run dev
# Run testsnpm test
# Run the server directlynode dist/index.js

Troubleshooting

Architecture

AI Assistant (MCP Client)       │  (MCP Protocol over stdio)       ▼mcp-nano-banana Server       │  (HTTPS POST)       ▼Google Gemini API       │       ▼Generated Image → saved to outputPath (or returned inline base64)

License

MIT

Author

codeFi