MCP 服务器

Nano-Banana-MCP

A Nano Banana MCP server, which you can integrate to cursor/claude code and any mcp client

README

Nano-Banana MCP Server 🍌

🤖 This project was entirely generated by Claude Code - an AI coding assistant that can create complete, production-ready applications from scratch.

A Model Context Protocol (MCP) server that provides AI image generation and editing capabilities using Google's Gemini 2.5 Flash Image API. Generate stunning images, edit existing ones, and iterate on your creations with simple text prompts.

✨ Features

🎨 Generate Images: Create new images from text descriptions
✏️ Edit Images: Modify existing images with text prompts
🔄 Iterative Editing: Continue editing the last generated/edited image
🖼️ Multiple Reference Images: Use reference images for style transfer and guidance
🌍 Cross-Platform: Smart file paths for Windows, macOS, and Linux
🔧 Easy Setup: Simple configuration with API key
📁 Auto File Management: Automatic image saving with organized naming

🔑 Setup

Get your Gemini API key:
- Visit Google AI Studio
- Create a new API key
- Copy it for configuration
Configure the MCP server: See configuration examples for your specific client below (Claude Code, Cursor, or other MCP clients).

💻 Usage with Claude Code

Configuration:

Add this to your Claude Code MCP settings:

Option A: With environment variable (Recommended - Most Secure)

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["nano-banana-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    }
  }
}

Option B: Without environment variable

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["nano-banana-mcp"]
    }
  }
}

Usage Examples:

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

🎯 Usage with Cursor

Configuration:

Add to your Cursor MCP configuration:

Option A: With environment variable (Recommended)

{
  "nano-banana": {
    "command": "npx",
    "args": ["nano-banana-mcp"],
    "env": {
      "GEMINI_API_KEY": "your-gemini-api-key-here"
    }
  }
}

Option B: Without environment variable

{
  "nano-banana": {
    "command": "npx",
    "args": ["nano-banana-mcp"]
  }
}

Usage Examples:

Ask Cursor to generate images for your app
Create mockups and prototypes
Generate assets for your projects

🔧 For Other MCP Clients

If you're using a different MCP client, you can configure nano-banana-mcp using any of these methods:

Configuration Methods

Method A: Environment Variable in MCP Config (Recommended)

{
  "nano-banana": {
    "command": "npx",
    "args": ["nano-banana-mcp"],
    "env": {
      "GEMINI_API_KEY": "your-gemini-api-key-here"
    }
  }
}

Method B: System Environment Variable

export GEMINI_API_KEY="your-gemini-api-key-here"
npx nano-banana-mcp

Method C: Using the Configure Tool

npx nano-banana-mcp
# The server will prompt you to configure when first used
# This creates a local .nano-banana-config.json file

🛠️ Available Commands

`generate_image`

Create a new image from a text prompt.

generate_image({
  prompt: "A futuristic city at night with neon lights"
})

`edit_image`

Edit a specific image file.

edit_image({
  imagePath: "/path/to/image.png",
  prompt: "Add a rainbow in the sky",
  referenceImages?: ["/path/to/reference.jpg"] // optional
})

`continue_editing`

Continue editing the last generated/edited image.

continue_editing({
  prompt: "Make it more colorful",
  referenceImages?: ["/path/to/style.jpg"] // optional
})

`get_last_image_info`

Get information about the last generated image.

get_last_image_info()

`configure_gemini_token`

Configure your Gemini API key.

configure_gemini_token({
  apiKey: "your-gemini-api-key"
})

`get_configuration_status`

Check if the API key is configured.

get_configuration_status()

⚙️ Configuration Priority

The MCP server loads your API key in the following priority order:

🥇 MCP Configuration Environment Variables (Highest Priority)
- Set in your claude_desktop_config.json or MCP client config
- Most secure as it's contained within the MCP configuration
- Example: "env": { "GEMINI_API_KEY": "your-key" }
🥈 System Environment Variables
- Set in your shell/system environment
- Example: export GEMINI_API_KEY="your-key"
🥉 Local Configuration File (Lowest Priority)
- Created when using the configure_gemini_token tool
- Stored as .nano-banana-config.json in current directory
- Automatically ignored by Git and NPM

💡 Recommendation: Use Method 1 (MCP config env variables) for the best security and convenience.

📁 File Storage

Images are automatically saved to platform-appropriate locations:

Windows: %USERPROFILE%\\Documents\\nano-banana-images\\
macOS/Linux: ./generated_imgs/ (in current directory)
System directories: ~/nano-banana-images/ (when run from system paths)

File naming convention:

Generated images: generated-[timestamp]-[id].png
Edited images: edited-[timestamp]-[id].png

🎨 Example Workflows

Basic Image Generation

generate_image - Create your base image
continue_editing - Refine and improve
continue_editing - Add final touches

Style Transfer

generate_image - Create base content
edit_image - Use reference images for style
continue_editing - Fine-tune the result

Iterative Design

generate_image - Start with a concept
get_last_image_info - Check current state
continue_editing - Make adjustments
Repeat until satisfied

🔧 Development

This project was created with Claude Code and follows these technologies:

TypeScript - Type-safe development
Node.js - Runtime environment
Zod - Schema validation
Google GenAI - Image generation API
MCP SDK - Model Context Protocol

Local Development

# Clone the repository
git clone https://github.com/claude-code/nano-banana-mcp.git
cd nano-banana-mcp

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npm test