GoogleのGeminiモデルを通じてAI搭載の画像生成機能とインテリジェントモデル選択機能を備えた本番環境対応の**Model Context Protocol(MCP)**サーバーです。

⭐ NEW:ナノバナナ2 — ジェミニ3.1フラッシュイメージ!🍌🚀

Nano Banana 2(gemini-3.1-flash-image-preview)が現在デフォルトモデルとなり、Flash速度でプロレベルの品質を提供します:

• 🍌 フラッシュ速度+4K画質:Gemini 2.5で最大3840pxフラッシュレイテンシ
• 🌐 Google検索グラウンディング:事実に忠実な画像のための実世界の知識
• 🎯 主語一貫性:シーンごとに最大5文字と14個のオブジェクト
• ✍️ 高精度テキストレンダリング:画像内でのクリアなテキスト配置
• 🏆 Gemini 3 Pro Image 最大限の推論深度のために依然として利用可能

✨ 特徴

• 🎨 マルチモデルAI画像生成:インテリジェント自動選択を備えた3つのジェミニモデル
• 🍌 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).