Google Gemini** 모델을 통해 AI 기반 이미지 생성 기능을 제공하는 운영 준비가 된 Model Context Protocol(MCP) 서버와 지능형 모델 선택 기능을 제공합니다.

⭐ NEW: 나노 바나나 2 — 제미니 3.1 플래시 이미지! 🍌🚀

나노 바나나 2 (gemini-3.1-flash-image-preview)가 현재 기본 모델 — 플래시 속도에서 프로급 품질을 제공합니다:

• 🍌 플래시 속도 + 4K 품질: Gemini 2.5에서 최대 3840px 플래시 지연
• 🌐 Google Search Grounding: 사실에 근거한 이미지를 위한 실제 지식
• 🎯 주제 일관성: 장면당 최대 5인물과 14개의 객체
• ✍️ 정밀 텍스트 렌더링: 이미지 내 명확한 텍스트 배치
• 🏆 Gemini 3 Pro Image는 최대 추론 깊이를 위해 여전히 이용 가능합니다

✨ 특징

• 🎨 다중 모델 AI 이미지 생성: 지능형 자동 선택 기능을 갖춘 세 가지 제미니 모델
• 🍌 Gemini 3.1 플래시 이미지 (NB2): 기본 모델 — 플래시 속도 및 접지 기반 4K 해상도
• 🏆 Gemini 3 Pro Image: 가장 복잡한 구도에 대한 최대 추론 깊이
• ⚡ Gemini 2.5 플래시 이미지: 대량 고속 프로토타이핑을 위한 레거시 플래시 모델

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