Which integrations are available for this server?

Provides AI-powered image generation, editing, and combination using Google Gemini models (Nano Banana Pro, Nano Banana 2, Nano Banana). Supports text-to-image, image editing with reference images, and multi-image composition at various resolutions and aspect ratios.

How do I use mcp-nano-banana?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-nano-banana create a 1024x1024 image of a futuristic robot holding a banana" 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.

mcp-nano-banana

by codeFi

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

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

Related MCP server: Nano-Banana MCP Server

Quick Start

Prerequisites

Get a Gemini API key from Google AI Studio
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

Model	MCP Name	Description	Max Ref Images
`gemini-3-pro-image-preview`	Nano Banana Pro	High quality, thinking mode, professional assets	6 object + 5 character
`gemini-3.1-flash-image-preview`	Nano Banana 2	Fast, high-efficiency, 1:4/4:1/1:8/8:1 ratios	10 object + 4 character
`gemini-2.5-flash-image`	Nano Banana	Fastest, optimized for high-volume tasks	-

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

Available Parameters

Resolution

Value	Approx. Pixels	Supported Models
`"512"`	~512px	Nano Banana 2 only
`"1K"`	~1024px	All models
`"2K"`	~2048px	All models
`"4K"`	~4096px	All models

Default: "1K"

Aspect Ratio

Value	Dimensions at 1K	Common Use Case
`1:1`	1024×1024	Social posts, icons
`16:9`	1344×768	Headers, presentations
`9:16`	768×1344	Stories, mobile
`4:3`	1152×896	Desktop, photos
`3:4`	896×1152	Portraits
`2:3`	~896×1344	Print, magazines
`3:2`	~1344×896	Photos
`4:5`	~896×1120	Instagram posts
`5:4`	~1120×896	Instagram landscape
`21:9`	~2048×878	Ultra-wide banners
`1:4`	~512×2048	Nano Banana 2 only — tall strips
`4:1`	~2048×512	Nano Banana 2 only — wide strips
`1:8`	~512×4096	Nano Banana 2 only — extra tall
`8:1`	~4096×512	Nano Banana 2 only — extra wide

Tools

`generate_image`

Generate or edit images from text prompts.

Parameter	Type	Required	Default	Description
`prompt`	string	✅ Yes	—	Text description or editing instructions
`imagePaths`	string[]	No	—	Reference image paths on disk (up to 14)
`model`	string	No	`gemini-3-pro-image-preview`	Model to use
`aspectRatio`	string	No	`1:1`	See table above for all options
`resolution`	string	No	`1K`	`512`, `1K`, `2K`, or `4K`
`outputFormat`	string	No	`png`	`png`, `jpeg`, `webp`
`outputPath`	string	No	—	Save image to this file path

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.

Parameter	Type	Required	Default	Description
`prompt`	string	No*	—	Icon description (required if `imagePath` not set)
`imagePath`	string	No*	—	Path to existing master icon image
`model`	string	No	`gemini-3-pro-image-preview`	Model for prompt generation
`outputDir`	string	No	—	Directory for individual favicon files
`outputPath`	string	No	—	Save ZIP package to this path
`returnZipBase64`	boolean	No	`false`	Return ZIP as base64 text
`appName`	string	No	`My App`	Manifest `name`
`shortName`	string	No	`App`	Manifest `short_name`
`themeColor`	string	No	`#ffffff`	Manifest theme color
`backgroundColor`	string	No	`#ffffff`	Manifest background color
`includeReadme`	boolean	No	`true`	Include README.md in package

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:

Model	1K	2K	4K
Nano Banana 2	~$0.04	~$0.08	~$0.15
Nano Banana Pro	~$0.06	~$0.13	~$0.24

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

Issue	Solution
`GEMINI_API_KEY is not set`	Export the env var or add it to your MCP config
`429 Too Many Requests`	Server auto-falls back to Flash model. Add billing to your account.
`403/402 Quota exceeded`	Enable billing at Google Cloud Console
`503 Unavailable`	High demand — retry in a moment. Common with 4K requests.
Image not updating after edit	Make sure you rebuilt the TypeScript (`npm run build`)
`imagePaths` not found	Use absolute paths. Relative paths may not resolve correctly.

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

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

2moRelease cycle

2Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Nano Banana MCP Server
Image & Video Processing Multimedia Processing
NH-5
F
license
B
quality
D
maintenance
An MCP server that enables image generation using Google's Gemini Nano Banana Pro model via the Google AI Studio API. Users can generate and save images locally by providing text prompts through MCP-compatible clients.
Last updated 2026-02-20
1
Nano-Banana MCP Server
AI & Machine Learning Image & Video Processing
bongartzdiaz
A
license
A
quality
D
maintenance
An MCP server that provides AI image generation and editing capabilities using Google's Gemini 2.5 Flash Image API. It allows users to create new images from text, modify existing files, and perform iterative edits through natural language prompts.
Last updated 2026-03-28
6
971
MIT
MCP Banana Image
Image & Video Processing AI & Machine Learning Multimedia Processing
Trigi-Digital
A
license
-
quality
C
maintenance
AI-powered image generation MCP server with 16 specialized tools for generating, editing, analyzing, and processing images using Google's Nano Banana 2 model. Supports custom API endpoints and integrates with AI coding assistants via natural language.
Last updated 2026-03-01
101
1
MIT
nano-banana-claude
AI & Machine Learning Image & Video Processing
tougenrip
A
license
-
quality
C
maintenance
An 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.
Last updated 2026-06-09
1
MIT

View all related MCP servers

Related MCP Connectors

mcp-nanobanana-pro
MCP server for NanoBanana AI image generation and editing
mcp-flux-pro
MCP server for Flux AI image generation
mcp-veo
MCP server for Google Veo AI video generation

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/codeFi/mcp-nano-banana'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

mcp-nano-banana

Features

Quick Start

Prerequisites

Installation

MCP Configuration

Codex

Qwen Code

Claude Code

Other MCP Clients

Local / Development Build

Models

Available Parameters

Resolution

Aspect Ratio

Tools

generate_image

Examples

generate_favicons

Example

Pricing

Supported Image Formats

Development

Troubleshooting

Architecture

License

Author

Maintenance

Resources

Looking for Admin?

Related MCP Servers

Nano Banana MCP Server

Nano-Banana MCP Server

MCP Banana Image

nano-banana-claude

Related MCP Connectors

Latest Blog Posts

MCP directory API

`generate_image`

`generate_favicons`