** 🤖 이 프로젝트는 전적으로 Claude Code**에 의해 생성되었습니다. Claude Code는 완전한 프로덕션 준비 애플리케이션을 처음부터 만들 수 있는 AI 코딩 어시스턴트입니다.

구글의 Gemini 2.5 Flash Image API를 활용한 AI 이미지 생성 및 편집 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 멋진 이미지를 생성하고, 기존 이미지를 편집하며, 간단한 텍스트 프롬프트로 창작물을 반복 수정할 수 있습니다.

✨ 특징

• 🎨 이미지 생성: 텍스트 설명에서 새 이미지 생성
• ✏️ 이미지 편집: 텍스트 프롬프트로 기존 이미지를 수정할 수 있습니다
• 🔄 반복 편집: 마지막으로 생성/편집된 이미지를 계속 편집합니다
• 🖼️ 다중 참조 이미지: 스타일 전달과 안내를 위해 참조 이미지 사용
• 🌍 크로스 플랫폼: Windows, macOS, Linux용 스마트 파일 경로
• 🔧 쉬운 설정: API 키로 간단한 구성
• 📁 자동 파일 관리: 체계적인 이름 붙여진 자동 이미지 저장

🔑 준비

1. Gemini API 키를 받아보세요:

• 구글 AI 스튜디오 방문
• 새로운 API 키 생성
• 설정을 위해 복사하기

2. MCP 서버 구성 완료: 아래의 특정 클라이언트(Claude 코드, 커서 또는 기타 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)