mcpField
N
nano-banana-mcp

nano-banana-mcp

本地服务
github.com/fjacquet媒体与设计03 周前更新
代码仓库

关于 nano-banana-mcp

nano-banana-mcp 是一个使用 Google Gemini 生成和编辑图像的 MCP 服务，支持多个 Nano Banana 模型变体，并提供迭代编辑和图像状态查询工具。

主要功能

  1. 01根据文本提示生成图像
  2. 02使用可选参考图编辑图像
  3. 03继续编辑最近生成的图像
  4. 04选择受支持的 Gemini 模型
  5. 05查看配置和最近图像详情

适用场景

  1. 01根据文字描述创建图像
  2. 02参考图片修改现有图像
  3. 03迭代优化最近生成的图像

MCP 相关

该服务向 Claude Code、Cursor 等 MCP 客户端提供图像生成、编辑、配置和图像信息工具。使用 Gemini API 密钥进行配置。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "fjacquet-nano-banana": {
      "command": "npx",
      "args": [
        "-y",
        "@fjacquet/nano-banana-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}
启动命令npx -y @fjacquet/nano-banana-mcp
需要配置的环境变量
GEMINI_API_KEY密钥Gemini API key from Google AI Studio. Optional: it can also be set later with the configure_gemini_token tool.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@fjacquet/nano-banana-mcp3.2.1

工具

6

收录的工具列表 · 更新于 2 周前

参数类型必填说明
apiKeystring是你的 Google AI Studio Gemini API 密钥

详细介绍

Nano-Banana MCP Server

npm version CI License: MIT Node.js >= 18 Release License

一个使用 Google Gemini 生成和编辑 AI 图像的 MCP 服务。可与 Claude Code、Cursor 和其他 MCP 客户端配合使用。

支持的模型：

品牌名称模型 ID备注
Nano Banana 2.1gemini-nano-banana-2.1默认模型 — 以 Flash 的速度提供专业级质量
Nano Banana Progemini-3-pro-image最高质量，支持高级推理
Nano Banana 2gemini-3.1-flash-image之前的默认模型
Nano Banana 2 Litegemini-3.1-flash-lite-image速度最快、成本最低 — 仅支持 1K 输出
Nano Bananagemini-2.5-flash-image旧版 — Google 将于 2027-03-15 停止服务

快速开始

  1. 从 Google AI Studio 获取 Gemini API 密钥

  2. 添加到 MCP 客户端配置中（Claude Code 示例）：

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["-y", "github:fjacquet/Nano-Banana-MCP"],
      "env": {
        "GEMINI_API_KEY": "your-key-here"
      }
    }
  }
}

有关 Cursor 和其他 MCP 客户端的配置，请参阅 docs/configuration.md。

  1. 使用这些工具：
Generate an image of a sunset over mountains
Edit this image to add some birds in the sky
Continue editing to make it more dramatic

工具

工具描述
generate_image根据文本提示词创建新图像
edit_image修改现有图像，可选择使用参考图像
continue_editing迭代编辑上一张图像
get_last_image_info获取上一张图像的信息
configure_gemini_token设置 API 密钥
get_configuration_status检查配置

所有生成和编辑工具都接受可选的 model 参数，用于选择模型。

完整 API 参考请参阅 docs/tools.md，设置详情请参阅 docs/configuration.md，使用模式请参阅 docs/workflows.md。

开发

npm install
npm run dev          # Run with tsx
npm run build        # Compile TypeScript
npm test             # Run tests
npm run lint         # Lint
npm run typecheck    # Type-check

需要 Node.js >= 18.0.0。

许可证

MIT — 请参阅 LICENSE。

Fork 自 ConechoAI/Nano-Banana-MCP。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。