NanoBanana Pro 2

NanoBanana MCP 服务

使用 NanoBanana Pro 2 进行 AI 图像生成的 MCP 服务。支持 Pro（最高画质）和 Flash（快速生成）模型，默认分辨率为 4K。

灵感来自 MCP 社区中广泛使用的 nano-banana 命名惯例。这是一个独立实现。

快速安装

pip install nanobanana-imagen-mcp
# or
uvx nanobanana-imagen-mcp --help

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["nanobanana-imagen-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      }
    }
  }
}

变量	描述	默认值
GEMINI_API_KEY	Gemini API 密钥 — 所有生成操作都必需	--
IMAGE_OUTPUT_DIR	生成图像的保存目录	~/nanobanana-images
NANOBANANA_DB_PATH	图像元数据的 SQLite 数据库路径	~/nanobanana-images/images.db

功能

使用 NanoBanana Pro 2 模型生成 AI 图像。支持文生图、使用参考图像编辑图像、文件上传和服务维护。可生成最高分辨率达 4K 的高质量图像。

工具（4 个）

工具	描述
generate_image	使用 NanoBanana Pro 2 生成图像。支持模型选择（Pro/Flash）、宽高比、分辨率（最高 4K）、负面提示词、思考级别、grounding、参考图像和批量生成。
upload_file	上传用于图像编辑或条件控制的参考图像。
show_output_stats	显示生成图像的统计信息 — 数量、总大小和文件详情。
maintenance	服务维护与清理 — 清除缓存、删除临时文件、优化存储。

模型

模型	引擎	最适用于
Pro	Gemini 3 Pro Image	最高画质、复杂场景、照片级真实感
Flash	Gemini 3.1 Flash Image	快速生成、简单场景、快速迭代

配置

变量	描述	默认值
GEMINI_API_KEY	Gemini API 密钥（必需）	--
IMAGE_OUTPUT_DIR	生成图像的输出目录	~/nanobanana-images

存储

生成图像的元数据会记录在 SQLite 数据库中。

变量	描述	默认值
NANOBANANA_DB_PATH	SQLite 元数据数据库的路径	~/nanobanana-images/images.db

退出持久化存储，可将 NANOBANANA_DB_PATH=:memory: 作为设置值。这会使用内存数据库，并在服务退出时丢弃 — 适用于临时或只读环境。取舍是：重启后图像历史记录会丢失；每次会话中，show_output_stats 工具都会显示空数据库。

数据库和输出目录会在首次生成图像时按需创建 — 在未设置 GEMINI_API_KEY 的情况下启动服务（例如运行 nanobanana-imagen-mcp --help）不会创建任何文件或目录。

Claude Desktop 配置

从 pip 安装（推荐）

pip install nanobanana-imagen-mcp

{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["nanobanana-imagen-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      }
    }
  }
}

从此代码仓库安装

{
  "mcpServers": {
    "nanobanana": {
      "command": "python",
      "args": ["-m", "servers.nanobanana.nanobanana_mcp_server.server"],
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      },
      "cwd": "path/to/gemini-media-mcp"
    }
  }
}

功能特性

• 默认使用 4K 分辨率，呈现丰富细节
• Pro 模型适用于复杂、照片级真实感的场景
• Flash 模型适用于快速迭代和简单主体
• 支持参考图像，便于生成一致的多角度照片
• 支持负面提示词，便于控制质量
• 可控制思考级别，适用于复杂的多元素场景
• 使用 Google Search grounding 获取真实世界主体信息

许可证

MIT

致谢

灵感来自 MCP 社区中广泛使用的 nano-banana 命名惯例。这是一个独立实现。