Nano Banana Pro MCP Server
Enables native image generation, editing, and composition using Google Gemini 2.0 Flash API, supporting text-to-image creation, iterative image editing, multi-image composition (up to 14 images), and Google Search grounding for real-time information-based generation with customizable aspect ratios and resolutions up to 4K.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Nano Banana Pro MCP Server generate a modern app icon with gradient blue background and clean typography"
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.
Nano Banana Pro MCP Server
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
Docker Desktop installed and running
Gemini API key from Google AI Studio
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 input3. Add to Claude Code
Add the MCP server to Claude Code using one of these methods:
Option A: Using claude mcp add (Recommended)
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-mcpOption 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 createaspectRatio(optional): 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9resolution(optional): 1K, 2K, or 4KuseGoogleSearch(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 resolutionedit_image
Edit an existing image with text instructions.
Parameters:
imagePath(required): Path to the image fileprompt(required): Description of the modificationsreferenceImages(optional): Array of reference image pathsaspectRatio(optional): Output aspect ratioresolution(optional): Output resolution
Example:
Edit /input/logo.png - Change the background color to gradient blue and
add a subtle glow effect around the textcontinue_editing
Continue editing the last generated/edited image.
Parameters:
prompt(required): Description of additional modificationsreferenceImages(optional): Reference images for style transfer, etc.aspectRatio(optional): Output aspect ratioresolution(optional): Output resolution
Example:
Make the colors more vibrant and add a subtle drop shadowcompose_images
Combine multiple images into a new composition.
Parameters:
images(required): Array of image paths (up to 14)prompt(required): How to combine the imagesaspectRatio(optional): Output aspect ratioresolution(optional): Output resolution
Example:
Compose these product photos into a professional catalog layout
with consistent lighting and white backgroundget_last_image_info
Get information about the last generated image.
get_configuration_status
Check if the API key is configured.
Tips for Best Results
Be Descriptive: The more detail in your prompt, the better the result
Use Photography Terms: For realistic images, mention camera angles, lens types, lighting
Iterate: Use
continue_editingto refine images step by stepReference Images: Use up to 14 reference images for character consistency or style transfer
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 outputDevelopment
To run locally without Docker:
npm install
npm run build
GEMINI_API_KEY=your-key OUTPUT_DIR=./output npm startContributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT
Acknowledgments
Google Gemini for the image generation API
Model Context Protocol by Anthropic
Claude Code for the amazing AI coding assistant
Available Tools
6 toolscompose_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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
Generate and edit images and create short videos inside Claude. Prepaid credits, no subscription.
Make any photo or video you can describe, right from Claude.
Generate images and video from Claude with one API key.
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models. Up to 4 images per call, SVG vectorization, background removal, upscaling and image-to-video. Remote MCP with OAuth, no API keys.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables Claude and other AI assistants to generate high-quality images up to 4K resolution using Google's Gemini image models, with support for flexible aspect ratios, natural language editing, and Google Search grounding for accurate results.434 PyPI12MIT
- AlicenseAqualityDmaintenanceEnables AI image generation, editing, composition, and style transfer in Claude conversations using Google's Gemini 2.5 Flash model. Automatically saves generated images to a local directory.4176 npm11MIT
- AlicenseNot gradedqualityDmaintenanceIntegrates Google Gemini API capabilities into Claude Code, supporting text generation, image analysis, and AI image creation. It features specialized tools for creative brainstorming and managing multi-turn chat sessions.285 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables image generation and prompt enhancement within Claude.ai by leveraging Google Gemini models. It allows users to create visual content in various styles like photorealistic and 3D render directly through natural language.-