Nano Banana MCP 服务器 🍌

一个生产就绪的**模型上下文协议（MCP）**服务器，通过 Google Gemini 模型提供 AI 图像生成能力，并具备智能模型选择功能。

⭐ 新功能：Nano Banana 2 — Gemini 3.1 Flash Image！🍌🚀

Nano Banana 2（gemini-3.1-flash-image-preview）现在是默认模型——以 Flash 速度提供 Pro 级质量：

• 🍌 Flash 速度 + 4K 质量：最高 3840px，延迟与 Gemini 2.5 Flash 相当
• 🌐 Google 搜索 Grounding：利用真实世界知识生成事实准确的图像
• 🎯 主体一致性：每个场景最多 5 个角色和 14 个物体
• ✍️ 精准文字渲染：图像中文字位置清晰准确
• 🏆 Gemini 3 Pro Image 仍可用于最大推理深度

✨ 功能特性

• 🎨 多模型 AI 图像生成：三种 Gemini 模型，智能自动选择
• 🍌 Gemini 3.1 Flash Image（NB2）：默认模型——以 Flash 速度提供 4K 分辨率并支持 Grounding
• 🏆 Gemini 3 Pro Image：为最复杂的构图提供最大推理深度
• ⚡ Gemini 2.5 Flash Image：适用于大批量快速原型制作的旧版 Flash 模型
• 🤖 智能模型选择：根据您的提示词自动路由到 NB2 或 Pro
• 📐 宽高比控制 ⭐ 新功能：指定输出尺寸（1:1、16:9、9:16、21:9 等）
• 📋 智能模板：为摄影、设计和编辑预置的提示词模板
• 📁 文件管理：通过 Gemini Files API 上传和管理文件
• 🔍 资源发现：通过 MCP 资源浏览模板和文件元数据
• 🛡️ 生产就绪：全面的错误处理、日志记录和验证
• ⚡ 高性能：优化架构，智能缓存

🚀 快速开始

前置条件

1. Google Gemini API 密钥 - 在此免费获取
2. Python 3.11+（仅用于开发）

安装

选项 1：从 MCP 注册表安装（推荐） 此服务器可在模型上下文协议注册表中找到。搜索 "nanobanana" 或使用下面的 MCP 名称配合您的 MCP 客户端。

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

选项 2：使用 uvx

uvx nanobanana-mcp-server@latest

选项 3：使用 pip

pip install nanobanana-mcp-server

🔧 配置

认证方式

Nano Banana 通过 NANOBANANA_AUTH_METHOD 支持两种认证方式：

1. API 密钥（api_key）：使用 GEMINI_API_KEY。最适合本地开发和简单部署。
2. Vertex AI ADC（vertex_ai）：使用 Google Cloud 应用默认凭据（Application Default Credentials）。最适合在 Google Cloud（Cloud Run、GKE、GCE）上生产部署。
3. 自动（auto）：如果存在 API 密钥则默认使用，否则尝试 Vertex AI。

1. API 密钥认证（默认）

设置 GEMINI_API_KEY 环境变量。

2. Vertex AI 认证（Google Cloud）

所需环境变量：

• NANOBANANA_AUTH_METHOD=vertex_ai（或 auto）
• GCP_PROJECT_ID=your-project-id
• GCP_REGION=global（默认；Gemini 3 Pro Image 和 NB2 必需。仅旧版 2.5 Flash Image 模型使用 us-central1。）

前置条件：

• 启用 Vertex AI API：gcloud services enable aiplatform.googleapis.com
• 授予 IAM 角色：roles/aiplatform.user 给服务账号。

Claude Desktop

选项 1：使用已发布服务器（推荐）

添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["nanobanana-mcp-server@latest"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    }
  }
}

选项 2：使用本地源码（开发）

如果您从源代码运行，请指向您的本地安装：

{
  "mcpServers": {
    "nanobanana-local": {
      "command": "uv",
      "args": ["run", "python", "-m", "nanobanana_mcp_server.server"],
      "cwd": "/absolute/path/to/nanobanana-mcp-server",
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    }
  }
}

选项 3：使用 Vertex AI（ADC）

要使用 Google Cloud 应用默认凭据（而非 API 密钥）进行认证：

{
  "mcpServers": {
    "nanobanana-adc": {
      "command": "uvx",
      "args": ["nanobanana-mcp-server@latest"],
      "env": {
        "NANOBANANA_AUTH_METHOD": "vertex_ai",
        "GCP_PROJECT_ID": "your-project-id",
        "GCP_REGION": "global"
      }
    }
  }
}

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

Claude Code（VS Code 扩展）

I…