nano-banana-pro-mcp

MCP server that enables AI agents like Claude to generate images using Google's Gemini image generation models (including Nano Banana Pro - gemini-3-pro-image-preview).

Note: I thought it was cool that Google Antigravity could generate images using nanobanana so I stole the idea.

Example

Here's Claude Code using the MCP to generate a hero image for a travel landing page:

And the beautiful result:

Installation

Claude Code CLI

Then add your API key to the MCP config. Open ~/.claude.json and find the nano-banana-pro server entry, then add your key:

Note: Environment variables from your shell (like export GEMINI_API_KEY=...) are NOT passed to MCP servers. You must add the key directly in the JSON config.

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Codex CLI

Create or edit .mcp.json in your project directory (or ~/.mcp.json for global config):

Gemini CLI

Create or edit ~/.gemini/settings.json:

Get an API Key

Get a free Gemini API key from Google AI Studio.

Available Tools

generate_image

Generate an image from a text prompt. Optionally provide reference images to guide the style or content.

Parameters:

• prompt (required): Description of the image to generate

• model (optional): Gemini model to use (default: gemini-3-pro-image-preview)

  • gemini-3-pro-image-preview - Nano Banana Pro (highest quality)

  • gemini-2.5-flash-preview-05-20 - Nano Banana (fast)

  • gemini-2.0-flash-exp - Widely available fallback

• aspectRatio (optional): "1:1" | "3:4" | "4:3" | "9:16" | "16:9"

• imageSize (optional): "1K" | "2K" | "4K" (only for image-specific models)

• images (optional): Array of reference images to guide generation

  • Each image: { data: "base64...", mimeType: "image/png" }

Example prompts:

edit_image

Edit one or more images based on instructions.

Parameters:

• prompt (required): Instructions for how to edit the image(s)

• images (required): Array of images to edit

  • Each image: { data: "base64...", mimeType: "image/png" }

• model (optional): Gemini model to use (default: gemini-3-pro-image-preview)

Example prompts:

describe_image

Analyze and describe one or more images. Returns text only (no image generation).

Parameters:

• images (required): Array of images to analyze

  • Each image: { data: "base64...", mimeType: "image/png" }

• prompt (optional): Custom analysis prompt (default: general description)

• model (optional): Gemini model to use (default: gemini-3-pro-image-preview)

Example prompts:

Development

Setup

Testing

Manual Testing

Testing with MCP Inspector

Then set GEMINI_API_KEY in the inspector's environment and call the generate_image tool.

License

MIT