@saroby/nanobanana-mcp

Google Gemini image generation MCP server (Nano Banana).

Features

• generate_image - Generate images using Google Gemini models
  • flash mode: gemini-2.5-flash-image (fast, ~2-3s)
  • pro mode: gemini-3-pro-image-preview (high quality, ~5-8s)
• list_images - List generated images in a directory

Setup

Get API Key

1. Go to Google AI Studio
2. Create an API key

Install in Claude Code

claude mcp add nanobanana -e GEMINI_API_KEY=your-key-here -- npx -y @saroby/nanobanana-mcp

Manual Usage

GEMINI_API_KEY=your-key-here npx @saroby/nanobanana-mcp

Tools

generate_image

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | prompt | string | Yes | Image description (1-8192 chars) | | model | "flash" | "pro" | No | Model selection (default: flash) | | aspect_ratio | enum | No | 1:1, 16:9, 9:16, 4:3, 3:4 | | negative_prompt | string | No | Elements to exclude | | output_dir | string | No | Save directory (default: ./nanobanana-images) | | count | number | No | Number of images 1-4 (default: 1) |

list_images

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | directory | string | No | Directory to search (default: ./nanobanana-images) |

Development

npm install
npm run build
npm run dev  # watch mode

License

MIT