Gemini图像生成服务

一个封装Google Gemini图像生成API的服务,提供生成、编辑、组合和描述图像的功能,适用于LLM代理和各种开发工具。

  • by pauloFroes
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 pauloFroes/mcp-nano-banana

使用说明

mcp纳米香蕉

包装MCP服务器 Google Gemini图像生成API (Nano Banana)作为LLM代理的语义工具。

使用Gemini 2.5 Flash和Gemini 3 Pro直接从Claude Code、Codex、Cursor或任何MCP客户端生成、编辑、合成和描述图像。


先决条件

变量 在哪里可以找到
GEMINI_API_KEY 谷歌AI工作室 → 创建API密钥

备注:通过API生成图像需要在您的谷歌云项目上启用计费。免费层不支持通过API生成图像。

安装

克劳德代码

有三种安装范围可供选择:

范围 标志 配置文件 用例
本地 -s local .mcp.json 仅此项目(默认)
项目 -s project .claude/mcp.json 通过git与团队共享
用户 -s user ~/.claude/mcp.json 您的所有项目

快速设置(内联环境变量):

claude mcp add nano-banana -s user \
  -e GEMINI_API_KEY=your-key \
  -- npx -y github:pauloFroes/mcp-nano-banana

替换 -s user 和 -s local 或 -s project 根据需要。

持久设置(.env文件):

添加到您的 .mcp.json:

{
  "nano-banana": {
    "command": "npx",
    "args": ["-y", "github:pauloFroes/mcp-nano-banana"],
    "env": {
      "GEMINI_API_KEY": "${GEMINI_API_KEY}"
    }
  }
}

然后在你的 .env 文件:

GEMINI_API_KEY=your-api-key

看 .env.example 对于所有必需的变量。

法典

添加到您的Codex配置中:

[mcp_servers.nano-banana]
command = "npx"
args = ["-y", "github:pauloFroes/mcp-nano-banana"]
env_vars = ["GEMINI_API_KEY"]

克劳德桌面

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["-y", "github:pauloFroes/mcp-nano-banana"],
      "env": {
        "GEMINI_API_KEY": "your-key"
      }
    }
  }
}

光标

添加 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["-y", "github:pauloFroes/mcp-nano-banana"],
      "env": {
        "GEMINI_API_KEY": "your-key"
      }
    }
  }
}

VS代码

添加 .vscode/mcp.json 在您的项目中:

{
  "servers": {
    "nano-banana": {
      "command": "npx",
      "args": ["-y", "github:pauloFroes/mcp-nano-banana"],
      "env": {
        "GEMINI_API_KEY": "your-key"
      }
    }
  }
}

帆板运动

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["-y", "github:pauloFroes/mcp-nano-banana"],
      "env": {
        "GEMINI_API_KEY": "your-key"
      }
    }
  }
}

可用工具

工具 说明
generate_image 从文本提示生成图像(文本到图像)
edit_image 使用文本指令编辑/转换现有图像(图像到图像)
compose_images 使用文本指令将多个图像组合成一个新图像
describe_image 分析和描述图像的内容(图像到文本)

模型

型号 ID 分辨率 成本 最适合
闪光 (默认) gemini-2.5-flash 高达1K $0.039/img 快速迭代,草稿
专业版 gemini-3-pro 高达4K 0.134-0.24/img美元 最终质量,图像中的文字

认证

使用来自谷歌人工智能工作室的简单API密钥。密钥通过 GEMINI_API_KEY 环境变量,并作为 x-goog-api-key 每个请求的标题。无需OAuth或令牌刷新。

许可证

麻省理工学院