Nano Banana Mcp

io.github.fjacquetv3.2.1Updated Oct 11, 2026

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

VerifiedSTDIODesktop onlyAI & MLMedia & Design

Overview

AI-generated overview

Lets an assistant generate and iteratively edit images through Google Gemini image models using a Gemini API key.

What it does
This local MCP server exposes tools for AI image work: generate_image creates new images from text prompts, edit_image modifies existing images with optional reference images, and continue_editing iteratively refines the last image. It also offers get_last_image_info, configure_gemini_token to set the API key, and get_configuration_status to check configuration. Generation and editing tools accept an optional model parameter to pick among several Gemini image models.
When to use it
Use it when you want an assistant to create or revise images from natural-language prompts inside an MCP client such as Claude Code or Cursor, including multi-step edits of the same image. It suits desktop workflows where image generation is part of the task rather than a separate app.
Requirements
Runs as a local process over stdio, so it needs Node.js 18 or newer and npx. A Gemini API key from Google AI Studio is required, supplied through the GEMINI_API_KEY environment variable or set later with the configure_gemini_token tool. Network access to Google's Gemini API is needed.
Before you install
The server requires the GEMINI_API_KEY secret, which grants access to your Google AI Studio account and may incur usage costs on that account. Image prompts and any reference images you pass are sent to Google's Gemini API. The configure_gemini_token tool can set the key at runtime, so treat the running process as holding a credential.

Installation

In SourceWeft

  1. Open Nano Banana Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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 mountainsEdit this image to add some birds in the skyContinue 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 installnpm run dev          # Run with tsxnpm run build        # Compile TypeScriptnpm test             # Run testsnpm run lint         # Lintnpm run typecheck    # Type-check

Requires Node.js >= 18.0.0.

License

MIT — see LICENSE.

Fork of ConechoAI/Nano-Banana-MCP.

Source: README.md at commit dd44598

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v3.2.1LatestOct 11, 2026