Nano Banana

@mindstone/mcp-server-nano-banana

Nano Banana MCP 服务 — 通过模型上下文协议使用 Google Gemini 生成和编辑图像。利用 Google Gemini 的 AI 能力，根据文本描述生成图像并编辑现有图像。

状态

• 版本： 0.4.1 · npm
• 身份验证： API 密钥（GEMINI_API_KEY）
• 工具： 3（图像生成、图像编辑）
• 服务类型： cloud-api
• 机器可读： STATUS.json

要求

• Node.js 20+
• npm

一键安装

点击按钮后，宿主将提示你填写：GEMINI_API_KEY、NANO_BANANA_GEMINI_TIMEOUT_MS、NANO_BANANA_BRIDGE_TIMEOUT_MS。

{
  "mcpServers": {
    "Nano Banana": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-nano-banana"
      ],
      "env": {
        "GEMINI_API_KEY": "",
        "NANO_BANANA_GEMINI_TIMEOUT_MS": "180000",
        "NANO_BANANA_BRIDGE_TIMEOUT_MS": "30000"
      }
    }
  }
}

快速开始

安装与构建

cd <path-to-repo>/connectors/nano-banana
npm install
npm run build

npx（发布后使用）

npx -y @mindstone/mcp-server-nano-banana

本地

node dist/index.js

配置

环境变量

• GEMINI_API_KEY — Google Gemini API 密钥
• MCP_WORKSPACE_PATH — 可选的工作区路径，用于保存生成的图像
• MCP_HOST_BRIDGE_STATE — 可选的宿主桥接状态文件路径，用于凭据管理
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE 的向后兼容别名
• NANO_BANANA_GEMINI_TIMEOUT_MS — 可选的覆盖值（正整数，单位为毫秒），用于设置 Gemini 出站请求超时时间。默认值：180000（3 分钟）。如果使用 gemini-3-pro-image-preview 时，图像生成较慢并出现 TIMEOUT 错误，可增大此值；如果希望缩短等待上限，则可减小此值。
• NANO_BANANA_BRIDGE_TIMEOUT_MS — 可选的覆盖值（正整数，单位为毫秒），用于设置向宿主桥接服务发送请求的超时时间。默认值：30000。

宿主配置示例

Claude Desktop / Cursor

{
  "mcpServers": {
    "NanoBanana": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-nano-banana"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key"
      }
    }
  }
}

本地开发（无需发布到 npm）

{
  "mcpServers": {
    "NanoBanana": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/nano-banana/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key"
      }
    }
  }
}

工具（3 个）

配置

• configure_nano_banana_api_key — 保存用于图像生成的 Gemini API 密钥

图像生成

• nano_banana_generate — 根据文本描述生成图像
• nano_banana_edit — 使用 AI 编辑现有图像；支持最多 14 张参考图像（source_image_paths）进行多图合成／融合。每个源文件可以是工作区文件路径或 https:// URL——每张图像的大小上限为 20MB（包括本地文件），所有源文件的总大小也有限制；远程获取会受到 SSRF 防护（仅限 HTTPS、禁止用户信息、拒绝私有／环回／链路本地主机并重新验证 DNS、逐跳重新验证重定向，仅支持 PNG/JPEG/WebP）

这两个图像工具都接受工作区内可选的 save_path。保存操作不会覆盖文件：如果 save_path 处已存在文件（或符号链接），工具会返回 SAVE_EXISTS 错误（图像仍会以内嵌形式包含在结果中）——请选择其他路径，或删除现有文件。保存的文件仅所有者可读写（0600）。

生成和编辑的输出会在返回或保存前根据字节内容识别格式。支持 PNG、JPEG 和 WebP；其他或无法识别的格式（包括 GIF）会返回结构化的 UNSUPPORTED_IMAGE_FORMAT 错误，而不会被错误标记为其他格式。

输出分辨率

这两个图像工具都接受可选的 image_size 参数（"1K"、"2K" 或 "4K"；默认值为 "1K"，约为 1024px）。只有 Gemini 3 图像模型（gemini-3.1-flash-image-preview、gemini-3-pro-image-preview）支持更高分辨率；旧版 gemini-2.5-flash-image 始终生成约 1K 的输出，并且不接受显式设置的 image_size。

许可证

FSL-1.1-MIT — Functional Source License，版本 1.1，未来将采用 MIT 许可证。本软件将于 2030-04-08 转为 MIT 许可证。