MCP server: One MCP server.

Nano Banana

@fjacquetMCP server · External

AI image generation and editing with Google Gemini: Nano Banana 2.1, Pro and Lite models

Image generationv3.2.1MITTypeScript
Freeno charge per call

Runs on your machine from its package; the steps are below.

What it does

  1. Reads
  2. Writes
  3. High impact

Not assessed yet.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

npm@fjacquet/nano-banana-mcpv3.2.1

Run

npx -y @fjacquet/nano-banana-mcp

MCP client config

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": [
        "-y",
        "@fjacquet/nano-banana-mcp"
      ]
    }
  }
}
README2 min read

Nano-Banana MCP Server

npm version CI License: MIT Node.js >= 18 Release License

An MCP server for AI image generation and editing using Google Gemini. Works with Claude Code, Cursor, and other MCP clients.

Models supported:

Brand nameModel IDNotes
Nano Banana 2.1gemini-nano-banana-2.1Default — pro quality at Flash speed
Nano Banana Progemini-3-pro-imageHighest quality, advanced reasoning
Nano Banana 2gemini-3.1-flash-imagePrevious default
Nano Banana 2 Litegemini-3.1-flash-lite-imageFastest and cheapest — 1K output only
Nano Bananagemini-2.5-flash-imageLegacy — shut down by Google on 2027-03-15

Quick Start

  1. Get a Gemini API key from Google AI Studio

  2. Add to your MCP client config (Claude Code example):

json
{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["-y", "github:fjacquet/Nano-Banana-MCP"],
      "env": {
        "GEMINI_API_KEY": "your-key-here"
      }
    }
  }
}

See docs/configuration.md for Cursor and other MCP clients.

  1. Use the tools:
Generate an image of a sunset over mountains
Edit this image to add some birds in the sky
Continue editing to make it more dramatic

Tools

ToolDescription
generate_imageCreate new images from text prompts
edit_imageModify existing images with optional reference images
continue_editingIteratively edit the last image
get_last_image_infoGet info about the last image
configure_gemini_tokenSet API key
get_configuration_statusCheck configuration

All generation/editing tools accept an optional model parameter to choose between the two models.

See docs/tools.md for full API reference, docs/configuration.md for setup details, and docs/workflows.md for usage patterns.

Development

bash
npm install
npm run dev          # Run with tsx
npm run build        # Compile TypeScript
npm test             # Run tests
npm run lint         # Lint
npm run typecheck    # Type-check

Requires Node.js >= 18.0.0.

License

MIT — see LICENSE.

Fork of ConechoAI/Nano-Banana-MCP.

Similar modules

Browse Image generation