Gemini Nanobanana MCP Server

@Junhan2

代码仓库

基本信息

分类

AI 与智能体

许可证

MIT

传输方式

stdio

作者

Junhan2

提交者

gangjoon

关于 Gemini Nanobanana MCP Server

MCP server for Google Gemini 2.5 Flash Image preview (text-to-image, editing, composition)

#gemini#nanobanana#claude #chatgpt

Gemini Nanobanana MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "gemini-nanobanana-mcp": {
      "command": "npx",
      "args": [
        "gemini-nanobanana-mcp@latest"
      ],
      "env": {
        "GEMINI_API_KEY": "your-api-key",
        "AUTO_SAVE": "true",
        "DEFAULT_SAVE_DIR": "~/Pictures/AI-Images",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

Gemini Nanobanana MCP Server 工具

Generate an image from a text prompt using Gemini 2.5 Flash Image

Edit an image using a prompt. Provide one input image via base64 or file path.

Compose a new image using multiple input images and a guiding prompt.

Transfer style from a style image to a base image, guided by an optional prompt.

概览

What is Gemini Nanobanana Mcp?

Gemini Nanobanana Mcp is a beginner-friendly Model Context Protocol (MCP) server that brings Google’s Gemini 2.5 Flash image generation directly into Claude conversations. It enables text-to-image generation, image editing, multi-image composition, and style transfer—all through natural language prompts.

How to use Gemini Nanobanana Mcp?

Configure the server in Claude Desktop, Claude Code, or Cursor by adding a JSON entry with the npx command and your GEMINI_API_KEY environment variable. After restarting your client, simply ask Claude to generate, edit, or compose images. Images are auto-saved to ~/Downloads/gemini-images/ by default, and you can specify a custom path in your prompt.

Key features of Gemini Nanobanana Mcp

Text-to-image generation from any description
Edit uploaded images with natural language instructions
Combine multiple images into a collage or composition
Apply artistic style from one image to another
Auto‑save images to disk or disable with AUTO_SAVE=false
Optional HTTP mode for external integrations

Use cases of Gemini Nanobanana Mcp

Generate custom illustrations, logos, or concept art during a chat
Edit photos by describing the desired change (e.g., “make this black and white”)
Create collages by uploading multiple reference images
Apply a style reference image to a content image for artistic transfer
Automatically save every generated image to a local folder for later use

常见问题

What API key is required and where do I get it?

You need a Google AI Studio API key. Get one free at [Google AI Studio](https://aistudio.google.com/apikey) by signing in with your Google account.

How do I install Gemini Nanobanana Mcp in Claude Desktop on Mac?

Open Terminal and run the one‑line command provided in the README that writes the configuration JSON to `~/Library/Application Support/Claude/claude_desktop_config.json`, replacing `YOUR_API_KEY` with your actual key.

Why am I getting “GEMINI_API_KEY not set” error?

The API key is missing or incorrectly set. Double‑check your config file or environment variable, ensure there are no extra spaces, and restart your Claude client.

Can I change where images are saved or disable automatic saving?

Yes. Set `DEFAULT_SAVE_DIR` to a custom path, or set `AUTO_SAVE` to `false` to only save images when you explicitly request a path.

What image formats are supported and how do I get instant preview?

Supported formats: PNG, JPEG, WebP, and GIF. For instant preview in Claude Code, install the provided hooks from the repository—generated images will open automatically in Quick Look.

AI 与智能体分类下的更多 MCP 服务器

Pocket Network Agentic Marketplace: Pay-per-Call APIs

Pocket Network Foundation

MCP server for the Pocket Network agentic marketplace: search our catalog of data services and utilities and call them, paying per request in USDC on Base with x402. No account or API key. Search and describe are free; p

YouSpot MCP

YouSpot

Give an agent access to your YouSpot CRM: contacts, companies, notes, files, and your connected Gmail, Calendar, HubSpot, LinkedIn, Slack and X.

OpenZiti MCP Gateway

openziti

NetFoundry MCP Gateway enables secure, isolated access to Model Context Protocol (MCP) tools across distributed systems without exposing public endpoints. Zero trust gateway for MCP servers. Aggregate, filter, and secure

TruVerifAI Panel-review

TruVerifAI

TruVerifAI's Panel Review is the guardian agent for AI's highest-stakes coding decisions: four frontier models argue over an AI coding agent's riskiest designs, diffs, and commits before they execute, with local review g

HeyLead: LinkedIn Outreach & Lead Generation MCP Server

D4umak

HeyLead: AI agent for LinkedIn outreach. Finds the right people, writes in your voice, follows up and handles replies, from Claude Code, Cursor, any MCP client or a web dashboard.