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.

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

cd mcp-nano-banana npm install npm 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">

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 TypeScript

npm run build

Watch mode

npm run dev

Run tests

npm test

Run the server directly

node 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