图像生成与编辑服务

基于Google的Nano Banana图像生成模型(Gemini)的MCP服务器,通过自然语言从Claude Code或任何MCP客户端生成和编辑图像。

  • by Maheidem
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Maheidem/nanobanana-mcp

使用说明

@maheidem/纳米香蕉mcp

用于谷歌Nano Banana图像生成模型(Gemini)的MCP服务器。通过Claude Code或任何MCP客户端的自然语言生成和编辑图像。

特性

  • 文本到图像生成 具有可配置的型号、宽高比和分辨率(高达4K)
  • 图像编辑 通过自然语言——添加/删除元素、风格转换、修复
  • 迭代优化 --继续编辑上次生成的图像
  • 3个模型层 --Flash(便宜),Pro(工作室质量),Flash 2(性价比最高)
  • 仅文件路径 --响应中没有base64,防止上下文窗口溢出
  • 持久模型偏好 --选择一次,随处使用

模型

型号 ID 状态 最大分辨率 价格/图像
纳米香蕉 gemini-2.5-flash-image GA 1千 0.039美元
纳米香蕉Pro gemini-3-pro-image-preview 预览 4K 0.134美元-0.24美元
纳米香蕉2 gemini-3.1-flash-image-preview 预览 4K 0.045美元-0.151美元

先决条件

  • Node.js>=18
  • 谷歌人工智能API密钥 已启用计费 (图像生成没有免费层)
  • 把钥匙拿到 谷歌AI工作室

安装

克劳德代码(推荐)

claude mcp add nano-banana -e GEMINI_API_KEY=your-key -- npx --yes @maheidem/nanobanana-mcp

手册 .mcp.json

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["@maheidem/nanobanana-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-key"
      }
    }
  }
}

工具

nb_generate_image

从文本提示生成新图像。

参数 必填 说明
prompt 是 图像的文字描述
model 否 型号ID(使用已保存的首选项)
aspectRatio 否 例如。 16:9, 1:1, 9:16
imageSize 没有 512, 1K, 2K,或 4K
outputDir 否 保存目录(默认: NB_OUTPUT_DIR 或cwd)

nb_edit_image

使用自然语言指令编辑现有图像。

参数 必填 说明
imagePath 是 源图像的路径
prompt 是 编辑说明
referenceImagePaths 否 用于样式转换的参考图像
model 否 型号ID
aspectRatio 否 输出纵横比
imageSize 否 输出分辨率
outputDir 否 保存目录

nb_continue_editing

继续编辑上次生成/编辑的图像。

参数 必填 说明
prompt 是 新的编辑说明
model 否 型号ID
imageSize 否 输出分辨率
outputDir 否 保存目录

nb_get_last_image

获取有关上次生成/编辑的图像的元数据。没有API调用。

nb_list_models

列出可用型号并设置首选型号(持久化到磁盘)。

参数 必填 说明
setModel 否 要另存为默认值的型号ID

环境变量

变量 必填 描述
GEMINI_API_KEY 是 谷歌人工智能API密钥(或 GOOGLE_API_KEY)
NB_OUTPUT_DIR 否 生成图像的默认输出目录

许可证

麻省理工学院