** 🤖 Этот проект был полностью создан Claude Code** — AI-ассистентом по программированию, который может создавать полноценные, готовые к производству приложения с нуля.

Сервер Model Context Protocol (MCP), предоставляющий возможности генерации и редактирования изображений с помощью AI с помощью Flash API Google Gemini 2.5. Создавайте потрясающие изображения, редактируйте существующие и улучшайте свои творения с помощью простых текстовых подсказок.

✨ Особенности

• 🎨 Генерировать изображения: Создавать новые изображения из текстовых описаний
• ✏️ Редактировать изображения: Изменять существующие изображения с помощью текстовых подсказок
• 🔄 Итеративное редактирование: Продолжить редактирование последнего сгенерированного/отредактированного изображения
• 🖼️ Множественные эталонные изображения: Используйте эталонные изображения для передачи стиля и навигации
• 🌍 Кроссплатформенный: Умные пути к файлам для Windows, macOS и Linux
• 🔧 Easy Setup: Простая настройка с помощью ключа 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)