Nano Banana Pro MCP

🚀 nano-banana-pro-mcp

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

⚠️ Important Note

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

🚀 Quick Start

💻 Usage Examples

Basic Usage

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

And here is the beautiful result:

📦 Installation

Claude Code CLI

claude mcp add nano-banana-pro --env GEMINI_API_KEY=your_api_key_here -- npx @rafarafarafa/nano-banana-pro-mcp

Replace your_api_key_here with your actual Gemini API key.

Claude Desktop

Add the following configuration to your Claude Desktop configuration file:

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

{
  "mcpServers": {
    "nano-banana-pro": {
      "command": "npx",
      "args": ["@rafarafarafa/nano-banana-pro-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Codex CLI

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

{
  "mcpServers": {
    "nano-banana-pro": {
      "command": "npx",
      "args": ["@rafarafarafa/nano-banana-pro-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Gemini CLI

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

{
  "mcpServers": {
    "nano-banana-pro": {
      "command": "npx",
      "args": ["@rafarafarafa/nano-banana-pro-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

📚 Documentation

Get an API Key

Obtain a free Gemini API key from Google AI Studio.

Available Tools

generate_image

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

Parameters:

• prompt (required): A description of the image to be generated.
• model (optional): The 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 - A widely available fallback option.
• aspectRatio (optional): "1:1", "3:4", "4:3", "9:16", or "16:9".
• imageSize (optional): "1K", "2K", or "4K" (only applicable to image - specific models).
• images (optional): An array of reference images to guide the generation process. Each image should be in the format { data: "base64...", mimeType: "image/png" }.
• outputPath (optional): The file path where the generated image will be saved (e.g., /path/to/image.png).

Example prompts:

Generate an image of a sunset over mountains
Generate a logo in the style of this reference image [with image attached]
Generate a hero image and save it to ./assets/hero.png

edit_image

Edit one or more images based on given instructions.

Parameters:

• prompt (required): Instructions on how to edit the image(s).
• images (required): An array of images to be edited. Each image should be in the format { data: "base64...", mimeType: "image/png" }.
• model (optional): The Gemini model to use (default: gemini-3-pro-image-preview).
• outputPath (optional): The file path where the edited image will be saved (e.g., /path/to/image.png).

Example prompts:

Add sunglasses to this photo
Remove the background from this image
Combine these two images into one scene

describe_image

Analyze and describe one or more images. This tool only returns text (no image generation).

Parameters:

• images (required): An array of images to be analyzed. Each image should be in the format { data: "base64...", mimeType: "image/png" }.
• prompt (optional): A custom analysis prompt (default: general description).
• model (optional): The Gemini model to use (default: gemini-3-pro-image-preview).

Example prompts:

[default] Describe this image in detail
What objects are in this image?
How many people are in this photo?
What's the dominant color in this image?

🔧 Technical Details

Development

Setup

npm install
npm run build

Testing

npm test              # Run unit tests
npm run test:watch    # Run tests in watch mode
npm run typecheck     # Type check without emitting

Manual Testing

# Generate a real image and save to test-output.png
GEMINI_API_KEY=your_key npm run test:manual "a cute cat wearing sunglasses"

Testing with MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

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

📄 License

MIT