@maheidem/nanobanana-mcp

MCP server for Google's Nano Banana image generation models (Gemini). Generate and edit images via natural language from Claude Code or any MCP client.

Features

• Text-to-image generation with configurable model, aspect ratio, and resolution (up to 4K)

• Image editing via natural language — add/remove elements, style transfer, inpainting

• Iterative refinement — keep editing the last generated image

• 3 model tiers — Flash (cheap), Pro (studio-quality), Flash 2 (best value)

• File paths only — no base64 in responses, prevents context window overflow

• Persistent model preference — choose once, used everywhere

Related MCP server: MCP Banana Image

Models

Prerequisites

• Node.js >= 18

• A Google AI API key with billing enabled (no free tier for image generation)

• Get your key at Google AI Studio

Install

Claude Code (recommended)

claude mcp add nano-banana -e GEMINI_API_KEY=your-key -- npx --yes @maheidem/nanobanana-mcp

Manual .mcp.json

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["@maheidem/nanobanana-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-key"
      }
    }
  }
}

Tools

nb_generate_image

Generate a new image from a text prompt.

nb_edit_image

Edit an existing image with natural language instructions.

nb_continue_editing

Continue editing the last generated/edited image.

nb_get_last_image

Get metadata about the last generated/edited image. No API call.

nb_list_models

List available models and set a preferred model (persisted to disk).

Environment Variables

License

MIT