Skip to main content
Glama

Nano Banana Pro MCP Server

License: MIT MCP

An MCP (Model Context Protocol) server that brings Google Gemini 2.0 Flash native image generation capabilities directly into Claude Code and other MCP-compatible AI assistants.

Generate, edit, and compose images using natural language - all without leaving your coding environment.

Features

  • Generate Images: Create high-quality images from text prompts (up to 4K resolution)

  • Edit Images: Modify existing images with text instructions

  • Continue Editing: Iteratively refine the last generated image

  • Compose Images: Combine up to 14 reference images into new compositions

  • Google Search Grounding: Generate images based on real-time information

  • Multiple Aspect Ratios: Support for 1:1, 16:9, 9:16, 4:3, 3:4, and more

  • High Resolution: Output at 1K, 2K, or 4K resolution

Related MCP server: Gemini Nanobanana MCP

Prerequisites

Quick Start

1. Build the Docker Image

cd nano-banana-pro-mcp
docker build -t nano-banana-pro-mcp .

2. Create Output Directory

mkdir -p output input

3. Add to Claude Code

Add the MCP server to Claude Code using one of these methods:

claude mcp add nano-banana-pro \
  --transport stdio \
  -- docker run -i --rm \
    -e GEMINI_API_KEY=$GEMINI_API_KEY \
    -v $(pwd)/output:/output \
    -v $(pwd)/input:/input:ro \
    nano-banana-pro-mcp

Option B: Manual Configuration

Add to your Claude Code MCP configuration file (~/.claude/claude_desktop_config.json or similar):

{
  "mcpServers": {
    "nano-banana-pro": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "GEMINI_API_KEY",
        "-v", "/path/to/output:/output",
        "-v", "/path/to/input:/input:ro",
        "nano-banana-pro-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

generate_image

Generate a new image from a text prompt.

Parameters:

  • prompt (required): Text description of the image to create

  • aspectRatio (optional): 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9

  • resolution (optional): 1K, 2K, or 4K

  • useGoogleSearch (optional): Enable real-time information grounding

Example:

Generate a professional hero image for a tech startup website, showing a
modern office with developers collaborating, 16:9 aspect ratio, 2K resolution

edit_image

Edit an existing image with text instructions.

Parameters:

  • imagePath (required): Path to the image file

  • prompt (required): Description of the modifications

  • referenceImages (optional): Array of reference image paths

  • aspectRatio (optional): Output aspect ratio

  • resolution (optional): Output resolution

Example:

Edit /input/logo.png - Change the background color to gradient blue and
add a subtle glow effect around the text

continue_editing

Continue editing the last generated/edited image.

Parameters:

  • prompt (required): Description of additional modifications

  • referenceImages (optional): Reference images for style transfer, etc.

  • aspectRatio (optional): Output aspect ratio

  • resolution (optional): Output resolution

Example:

Make the colors more vibrant and add a subtle drop shadow

compose_images

Combine multiple images into a new composition.

Parameters:

  • images (required): Array of image paths (up to 14)

  • prompt (required): How to combine the images

  • aspectRatio (optional): Output aspect ratio

  • resolution (optional): Output resolution

Example:

Compose these product photos into a professional catalog layout
with consistent lighting and white background

get_last_image_info

Get information about the last generated image.

get_configuration_status

Check if the API key is configured.

Tips for Best Results

  1. Be Descriptive: The more detail in your prompt, the better the result

  2. Use Photography Terms: For realistic images, mention camera angles, lens types, lighting

  3. Iterate: Use continue_editing to refine images step by step

  4. Reference Images: Use up to 14 reference images for character consistency or style transfer

  5. Google Search: Enable for real-time data like weather, news, or current events

Output Location

Generated images are saved to the /output directory (mounted from ./output on your host).

Troubleshooting

"GEMINI_API_KEY not set"

Make sure your API key is set in your environment:

export GEMINI_API_KEY="your-key-here"

Images not appearing

Check the ./output directory on your host machine. Ensure the volume mount is correct.

Docker permission issues

On Linux, you may need to run:

sudo chown -R $USER:$USER output

Development

To run locally without Docker:

npm install
npm run build
GEMINI_API_KEY=your-key OUTPUT_DIR=./output npm start

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Acknowledgments

Available Tools

6 tools
compose_imagesA

Combine multiple images into a new composition. Perfect for product mockups, character consistency, and creative collages. Supports up to 14 reference images.

Inputs: images (required), prompt (required), aspectRatio, resolution.

continue_editingA

Continue editing the last generated/edited image in this session. Use for iterative improvements without specifying the file path.

Inputs: prompt (required), referenceImages, aspectRatio, resolution.

edit_imageB

Edit an existing image file using text instructions. Can add/remove elements, change styles, transfer styles from reference images, and more.

Inputs: imagePath (required), prompt (required), referenceImages, aspectRatio, +1 more.

generate_imageA

Generate a NEW image from text prompt using Gemini 3 Pro. Use this for creating completely new images from scratch. Supports high-resolution output (1K, 2K, 4K) and various aspect ratios.

Inputs: prompt (required), aspectRatio, resolution, useGoogleSearch.

get_configuration_statusA

Check if the Gemini API key is configured and ready to use.

Inputs: no named parameters.

get_last_image_infoA

Get information about the last generated/edited image in this session.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: composing multiple images, continuing edits on the last image, editing a specified image, generating new images, checking API configuration, and retrieving info about the last image. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with snake_case (e.g., compose_images, generate_image, get_configuration_status). The naming is predictable and clear.

    Tool Count5/5

    With 6 tools, the server is well-scoped for image generation and editing tasks. Each tool serves a necessary function without redundancy or excessive complexity.

    Completeness5/5

    The tool set covers the core image lifecycle: create (generate_image), edit (edit_image), composite (compose_images), iterative refinement (continue_editing), status check, and information retrieval. No obvious gaps for the intended purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers