Nano Banana MCP

🚀 Nano-Banana MCP Server 🍌

This is a Model Context Protocol (MCP) server that leverages Google's Gemini 2.5 Flash Image API to offer AI image generation and editing capabilities. With simple text prompts, you can generate stunning images, edit existing ones, and refine your creations iteratively.

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

✨ Features

• 🎨 Generate Images: Create new images based on text descriptions.
• ✏️ Edit Images: Modify existing images using text prompts.
• 🔄 Iterative Editing: Keep editing the last generated or edited image.
• 🖼️ Multiple Reference Images: Utilize reference images for style transfer and guidance.
• 🌍 Cross-Platform: Smart file paths support Windows, macOS, and Linux.
• 🔧 Easy Setup: Simple configuration with an API key.
• 📁 Auto File Management: Automatically save images with organized naming.

🚀 Quick Start

🔑 Setup

1. Get your Gemini API key:

   • Visit Google AI Studio.
   • Create a new API key.
   • Copy it for configuration.

2. Configure the MCP server: See configuration examples for your specific client below (Claude Code, Cursor, or other MCP clients).

📦 Installation

💻 Usage with Claude Code

Configuration:

Add the following 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 the following 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

💻 Usage Examples

Basic Usage

// Generate a new image
generate_image({
  prompt: "A futuristic city at night with neon lights"
})

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

// Continue editing the last generated/edited image
continue_editing({
  prompt: "Make it more colorful",
  referenceImages?: ["/path/to/style.jpg"] // optional
})

// Get information about the last generated image
get_last_image_info()

// Configure your Gemini API key
configure_gemini_token({
  apiKey: "your-gemini-api-key"
})

// Check if the API key is configured
get_configuration_status()

🔧 Technical Details

⚙️ Configuration Priority

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

1. 🥇 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" }

2. 🥈 System Environment Variables

   • Set in your shell/system environment.
   • Example: export GEMINI_API_KEY="your-key"

3. 🥉 Local Configuration File (Lowest Priority)

   • Created when using the configure_gemini_token tool.
   • Stored as .nano-banana-config.json in the 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 the 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

1. generate_image - Create your base image.
2. continue_editing - Refine and improve.
3. continue_editing - Add final touches.

Style Transfer

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

Iterative Design

1. generate_image - Start with a concept.
2. get_last_image_info - Check the current state.
3. continue_editing - Make adjustments.
4. 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

📋 Requirements

• Node.js 18.0.0 or higher.
• Gemini API key from Google AI Studio.
• Compatible with Claude Code, Cursor, and other MCP clients.

🤝 Contributing

This project was generated by Claude Code, but contributions are welcome! Please feel free to:

• Report bugs.
• Suggest new features.
• Submit pull requests.
• Improve documentation.

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

• Claude Code - For generating this entire project.
• Google AI - For the powerful Gemini 2.5 Flash Image API.
• Anthropic - For the Model Context Protocol.
• Open Source Community - For the amazing tools and libraries.

📞 Support

• 🐛 Issues: GitHub Issues
• 📖 Documentation: This README and inline code comments.
• 💬 Discussions: GitHub Discussions

✨ Generated with love by Claude Code - The future of AI - powered development is here!