纳米香蕉-mcp服务器

Name: 纳米香蕉-mcp服务器
Author: zhongweili

作者：zhongweili9 星标更新：2025-11-22

安装使用来源：spider==github.com

项目介绍

Nano Banana MCP Server 🍌

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

⭐ 新功能：Gemini 3 Pro 图像支持！🚀

现在支持Nano Banana Pro——Google最新且最强大的图像生成模型：

🏆 专业级4K质量：生成高达3840像素分辨率的惊艳图像
🌐 Google搜索基础：访问现实世界知识以生成事实准确的图像
🧠 高级推理：可配置的思考级别以处理复杂构图
🎯 卓越的文字渲染：在高分辨率下清晰呈现图像中的文字
🎨 增强的理解：更好地理解复杂的提示语境

✨ 特性

🎨 多模型AI图像生成：智能选择Flash（速度）和Pro（质量）模型
⚡ Gemini 2.5 Flash 图像：快速生成（1024像素）用于快速原型设计
🏆 Gemini 3 Pro 图像：最高可达4K质量并带有Google搜索基础
🤖 智能模型选择：根据您的提示自动选择最优模型
📐 纵横比控制 ⭐ 新功能：指定输出尺寸（1:1, 16:9, 9:16, 21:9等）
📋 智能模板：预建的提示模板适用于摄影、设计和编辑
📁 文件管理：通过Gemini Files API上传和管理文件
🔍 资源发现：浏览模板和文件元数据通过MCP资源
🛡️ 生产就绪：全面的错误处理、日志记录和验证
⚡ 高性能：优化架构和智能缓存

🚀 快速开始

前提条件

Google Gemini API密钥 - 在这里免费获取
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

🔧 配置

Claude Desktop

添加到您的claude_desktop_config.json：

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

配置文件位置：

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

Claude Code (VS Code扩展)

在VS Code中安装和配置：

安装Claude Code扩展
打开命令面板（Cmd/Ctrl + Shift + P）
运行"Claude Code: 添加MCP服务器"

配置：

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

Cursor

添加到Cursor的MCP配置：

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

Continue.dev (VS Code/JetBrains)

添加到您的config.json：

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

Open WebUI

在Open WebUI设置中配置：

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

Gemini CLI / 通用MCP客户端

# 设置环境变量
export GEMINI_API_KEY="your-gemini-api-key-here"

# 在标准I/O模式下运行服务器
uvx nanobanana-mcp-server@latest

# 或者使用pip安装
python -m nanobanana_mcp_server.server

🤖 模型选择

Nano Banana支持两种Gemini模型，并具有智能自动选择：

🏆 Pro模型 - Nano Banana Pro (Gemini 3 Pro 图像) ⭐ 新功能！

Google最新且最先进的图像生成模型

质量：专业级，生产就绪
分辨率：高达4K（3840像素）- 最高可用
速度：每张图像约5-8秒
特殊功能：
- 🌐 Google搜索基础：利用现实世界知识生成准确、有语境的图像
- 🧠 高级推理：可配置的思考级别（低/高）以处理复杂构图
- 📐 媒体分辨率控制：精细调整视觉处理细节（低/中/高/自动）
- 📝 卓越的文字渲染：生成图像中的文字具有异常清晰度
- 🎨 增强的语境理解：更好地解释复杂的叙述提示
最佳用途：生产资产、营销材料、专业摄影、高保真输出、需要文字和事实准确性的图像
成本：每张图像较高（优质）

⚡ Flash模型 (Gemini 2.5 Flash 图像)

快速可靠的模型，适合快速迭代

速度：非常快（2-3秒）
分辨率：高达1024像素
质量：日常使用高质量
最佳用途：快速原型设计、迭代、大量生成、草稿、草图
成本：每张图像较低

🤖 自动选择（推荐）

默认情况下，服务器使用AUTO模式，智能分析您的提示和需求：

当选择Pro模型时：

检测到质量关键词：“4K”，“专业”，“生产”，“高分辨率”，“高清”
请求高分辨率：resolution="4k" 或 resolution="high"
启用Google搜索基础：enable_grounding=True
请求高思考级别：thinking_level="HIGH"
多图像条件，多个输入图像

当选择Flash模型时：

检测到速度关键词：“快速”，“草稿”，“草图”，“快速”
高量批次生成：n > 2
标准或更低分辨率请求
不需要特殊Pro功能

使用示例

# 自动选择（推荐）
"生成一张专业的4K产品照片"  # → Pro模型（质量关键词 + 4K）
"快速绘制一只猫的草图"          # → Flash模型（速度关键词）
"创建一个带有清晰标签的图表"    # → Pro模型（文字渲染）
"网站英雄部分的草稿"           # → Flash模型（草稿关键词）

# 显式模型选择
generate_image(
    prompt="一幅风景画",
    model_tier="flash"  # 强制使用Flash模型以提高速度
)

# 利用Nano Banana Pro特性
generate_image(
    prompt="复古相机放在木桌上的专业产品照片",
    model_tier="pro",              # 使用Pro模型
    resolution="4k",               # 4K分辨率（仅Pro）
    thinking_level="HIGH",         # 增强推理
    enable_grounding=True,         # 使用Google搜索以确保准确性
    media_resolution="HIGH"        # 高细节视觉处理
)

# 为高质量文字渲染使用Pro模型
generate_image(
    prompt="展示2024市场统计数据的图表，带有清晰标签",
    model_tier="pro",              # Pro在文字渲染上表现出色
    resolution="4k"                # 文字的最大清晰度
)

# 控制不同格式的纵横比 ⭐ 新功能！
generate_image(
    prompt="日落时的电影风景",
    aspect_ratio="21:9"            # 超宽电影格式
)

generate_image(
    prompt="关于咖啡的Instagram帖子",
    aspect_ratio="1:1"             # 社交媒体的方形格式
)

generate_image(
    prompt="YouTube缩略图设计",
    aspect_ratio="16:9"            # 标准视频格式
)

generate_image(
    prompt="山景的手机壁纸",
    aspect_ratio="9:16"            # 手机的纵向格式
)

📐 纵横比控制 ⭐ 新功能！

使用aspect_ratio参数控制输出图像的尺寸：

支持的纵横比：

1:1 - 方形（Instagram，头像）
4:3 - 经典照片格式
3:4 - 纵向方向
16:9 - 宽屏（YouTube缩略图，演示）
9:16 - 移动纵向（手机壁纸，故事）
21:9 - 超宽电影
2:3, 3:2, 4:5, 5:4 - 各种照片格式

# 不同使用场景的例子
generate_image(
    prompt="电子商务的产品展示",
    aspect_ratio="3:4",    # 纵向格式，适合产品页面
    model_tier="pro"
)

generate_image(
    prompt="Facebook的社交媒体横幅",
    aspect_ratio="16:9"    # 横向横幅格式
)

注意：纵横比适用于Flash和Pro模型。对于特定纵横比的高分辨率最佳效果，请使用Pro模型并设置resolution="4k"。

⚙️ 环境变量

配置选项：

# 必需
GEMINI_API_KEY=your-gemini-api-key-here

# 模型选择（可选）
NANOBANANA_MODEL=auto  # 选项：flash, pro, auto（默认：auto）

# 可选
IMAGE_OUTPUT_DIR=/path/to/image/directory  # 默认：~/nanobanana-images
LOG_LEVEL=INFO                             # DEBUG, INFO, WARNING, ERROR
LOG_FORMAT=standard                        # standard, json, detailed

🐛 故障排除

常见问题

"GEMINI_API_KEY未设置"

将您的API密钥添加到客户端中的MCP服务器配置
在Google AI Studio免费获取API密钥

"服务器启动失败"

确保您使用的是最新版本：uvx nanobanana-mcp-server@latest
检查您的客户端是否支持MCP（Claude Desktop 0.10.0+）

"权限被拒绝"错误

服务器默认在~/nanobanana-images创建图像
确保对您的主目录有写权限

开发设置

本地开发：

# 克隆仓库
git clone https://github.com/zhongweili/nanobanana-mcp-server.git
cd nanobanana-mcp-server

# 使用uv安装
uv sync

# 设置环境
export GEMINI_API_KEY=your-api-key-here

# 本地运行
uv run python -m nanobanana_mcp_server.server

📄 许可证

MIT许可证 - 详情见LICENSE。

🆘 支持

问题：GitHub Issues
讨论：GitHub Discussions