** 🤖 该项目完全由Claude Code**生成——一款能够从零开始创建完整、具备生产环境的应用程序的AI编码助手。

一个模型上下文协议（MCP）服务器，利用谷歌Gemini 2.5 Flash图像API提供AI图像生成和编辑功能。生成惊艳图片，编辑现有图片，并通过简单的文本提示迭代你的作品。

✨ 特色

• 🎨 生成图片：从文本描述创建新图片
• ✏️ 编辑图片：通过文本提示修改现有图片
• 🔄 迭代编辑：继续编辑最后生成/编辑的图像
• 🖼️ 多重参考图片：使用参考图片进行风格传递和指导
• 🌍 跨平台：Windows、macOS和Linux的智能文件路径
• 🔧 简单设置：使用API密钥进行简单配置
• 📁 自动文件管理：自动保存图像并有组织命名

🔑 布置

1. 获取你的Gemini API密钥：

• 访问Google AI Studio
• 创建一个新的API密钥
• 复制以进行配置

2. 配置MCP服务器： 请参见下方针对您具体客户端（Claude Code、Cursor 或其他 MCP 客户端）的配置示例。

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

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).

💻 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)