MCP Nano Banana
An MCP (Model Context Protocol) server that exposes Google Gemini's image generation capabilities (Nano Banana / Nano Banana Pro) as tools that Claude can use.
Installation
git clone https://github.com/Pgarciapg/mcp-nano-banana.git
cd mcp-nano-banana
npm install
npm run build
Features
- Text-to-Image Generation: Generate images from text prompts
- Image Editing: Edit existing images using natural language
- Image Composition: Combine multiple images into new compositions
- Two Models Available:
nano-banana(gemini-2.5-flash-image): Fast, efficient, 1024px resolutionnano-banana-pro(gemini-3-pro-image-preview): Advanced, up to 4K, with thinking mode
Setup
1. Get a Gemini API Key
- Go to Google AI Studio
- Create or select a project
- Generate an API key
2. Set Your API Key
Add your Gemini API key to your shell profile (~/.zshrc or ~/.bashrc):
export GEMINI_API_KEY="your-api-key-here"
Then reload your shell:
source ~/.zshrc
3. Configure Claude Code
Add the server to Claude Code's MCP config. Edit ~/.claude/.mcp.json:
{
"mcpServers": {
"gemini-imagen": {
"command": "node",
"args": ["/path/to/mcp-nano-banana/dist/index.js"],
"env": {
"GEMINI_API_KEY": "${GEMINI_API_KEY}",
"IMAGEN_OUTPUT_DIR": "/path/to/output/folder"
}
}
}
}
4. Restart Claude Code
After configuring, restart Claude Code to load the new MCP server.
Available Tools
generate_image
Generate an image from a text prompt.
Parameters:
prompt(required): Text description of the image to generatemodel:nano-banana(default) ornano-banana-proaspect_ratio:1:1,2:3,3:2,3:4,4:3,4:5,5:4,9:16,16:9,21:9image_size:1K,2K,4K(only for nano-banana-pro)filename: Optional output filename
edit_image
Edit an existing image using text prompts.
Parameters:
prompt(required): Description of the edit to makeimage_path(required): Path to the input imagemodel: Model to use for editingaspect_ratio: Optional aspect ratio for outputimage_size: Resolution (only for nano-banana-pro)filename: Optional output filename
compose_images
Combine multiple images into a new composition.
Parameters:
prompt(required): How to combine the imagesimage_paths(required): Array of paths to input imagesmodel: Model to use (nano-banana-pro recommended)aspect_ratio: Aspect ratio for outputimage_size: Resolution (only for nano-banana-pro)filename: Optional output filename
Usage Examples
Generate a simple image
"Generate an image of a sunset over mountains with a cabin in the foreground"
Edit an existing image
"Add a wizard hat to the cat in this image" + provide image_path
Combine multiple images
"Put the dress from the first image on the model from the second image" + provide image_paths array
Prompting Tips
- Be Descriptive: Describe scenes narratively, not as keyword lists
- Specify Style: Use photography terms for photorealistic images (lens type, lighting, angles)
- Include Details: Mention colors, textures, lighting, and mood
- Use Templates: For specific styles (product photos, logos, etc.), follow proven templates
Environment Variables
GEMINI_API_KEY(required): Your Google Gemini API keyIMAGEN_OUTPUT_DIR(optional): Directory for generated images (defaults to./generated-images)
License
MIT