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

⭐ НОВИНКА: Nano Banana 2 — Flash Image Gemini 3.1! 🍌🚀

Nano Banana 2 (gemini-3.1-flash-image-preview) теперь является стандартной моделью — обеспечивая качество профессионального уровня на скорости Flash:

• 🍌 Скорость вспышки + качество 4K: до 3840px при задержке вспышки Gemini 2.5
• 🌐 Google Search Grounding: реальные данные для фактически точных изображений
• 🎯 Согласованность субъектов: до 5 символов и 14 объектов в каждой сцене
• ✍️ Точное рендеринг текста: кристально чистое размещение текста в изображениях
• 🏆 Gemini 3 Pro Image всё ещё доступно для максимальной глубины рассуждения

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

• 🎨 Многомодельная генерация AI-изображений: Три модели Gemini с интеллектуальным автоматическим выбором
• 🍌 Gemini 3.1 Flash Image (NB2): модель по умолчанию — разрешение 4K при скорости Flash с заземлением
• 🏆 Gemini 3 Pro Image: максимальная глубина мышления для самых сложных композиций
• ⚡ Gemini 2.5 Flash Image: Legacy Flash модель для быстрого прототипирования с большим объемом

Nano Banana MCP Server 🍌

A production-ready Model Context Protocol (MCP) server that provides AI-powered image generation capabilities through Google’s Gemini models with intelligent model selection.

⭐ NEW: Nano Banana 2 — Gemini 3.1 Flash Image! 🍌🚀

Nano Banana 2 (gemini-3.1-flash-image-preview) is now the default model — delivering Pro-level quality at Flash speed:

• 🍌 Flash Speed + 4K Quality: Up to 3840px at Gemini 2.5 Flash latency
• 🌐 Google Search Grounding: Real-world knowledge for factually accurate images
• 🎯 Subject Consistency: Up to 5 characters and 14 objects per scene
• ✍️ Precision Text Rendering: Crystal-clear text placement in images
• 🏆 Gemini 3 Pro Image still available for maximum reasoning depth

✨ Features

• 🎨 Multi-Model AI Image Generation: Three Gemini models with intelligent automatic selection
• 🍌 Gemini 3.1 Flash Image (NB2): Default model — 4K resolution at Flash speed with grounding
• 🏆 Gemini 3 Pro Image: Maximum reasoning depth for the most complex compositions
• ⚡ Gemini 2.5 Flash Image: Legacy Flash model for high-volume rapid prototyping
• 🤖 Smart Model Selection: Automatically routes to NB2 or Pro based on your prompt
• 📐 Aspect Ratio Control ⭐ NEW: Specify output dimensions (1:1, 16:9, 9:16, 21:9, and more)
• 📋 Smart Templates: Pre-built prompt templates for photography, design, and editing
• 📁 File Management: Upload and manage files via Gemini Files API
• 🔍 Resource Discovery: Browse templates and file metadata through MCP resources
• 🛡️ Production Ready: Comprehensive error handling, logging, and validation
• ⚡ High Performance: Optimized architecture with intelligent caching

🚀 Quick Start

Prerequisites

1. Google Gemini API Key - Get one free here
2. Python 3.11+ (for development only)

Installation

Option 1: From MCP Registry (Recommended) This server is available in the Model Context Protocol Registry. Search for “nanobanana” or use the MCP name below with your MCP client.

mcp-name: io.github.zhongweili/nanobanana-mcp-server

Option 2: Using uvx

uvx nanobanana-mcp-server@latest

Option 3: Using pip

pip install nanobanana-mcp-server

🔧 Configuration

Authentication Methods

Nano Banana supports two authentication methods via NANOBANANA_AUTH_METHOD:

1. API Key (api_key): Uses GEMINI_API_KEY. Best for local development and simple deployments.
2. Vertex AI ADC (vertex_ai): Uses Google Cloud Application Default Credentials. Best for production on Google Cloud (Cloud Run, GKE, GCE).