mcpField
G
Gemini Nanobanana Mcp

Gemini Nanobanana Mcp

本地服务
github.com/Junhan2AI 与智能体1159 周前更新
代码仓库

关于 Gemini Nanobanana Mcp

Gemini Nanobanana Mcp 将 Google Gemini 2.5 Flash Image 的图像生成功能接入 Claude 等 MCP 客户端，面向通过文本或现有图像创作内容的用户。它支持文本生成、图像编辑与组合，并可自动保存结果。

主要功能

  1. 01根据文本生成图像
  2. 02通过自然语言编辑图像
  3. 03组合多张图像
  4. 04应用参考图像的艺术风格
  5. 05自动保存生成的图像

适用场景

  1. 01从文字描述制作插图
  2. 02按指令修改上传的照片
  3. 03将多张图像组合成拼贴
  4. 04把参考图像的风格用于另一张图

MCP 相关

该 MCP 服务将 Gemini 图像生成能力提供给 MCP 客户端，支持通过工具生成、编辑和组合图像。可使用 stdio 或 HTTP 传输。

#gemini#nanobanana#claude#chatgpt

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "gemini-nanobanana": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-nanobanana-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "AUTO_SAVE": "<AUTO_SAVE>",
        "DEFAULT_SAVE_DIR": "<DEFAULT_SAVE_DIR>",
        "LOG_LEVEL": "<LOG_LEVEL>"
      }
    }
  }
}
启动命令npx -y gemini-nanobanana-mcp
需要配置的环境变量
GEMINI_API_KEY密钥
AUTO_SAVE
DEFAULT_SAVE_DIR
LOG_LEVEL

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

安装包
npmgemini-nanobanana-mcp

工具

4

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

参数类型必填说明
promptstring是详细的场景描述。要实现照片级真实感，请使用摄影术语。
saveToFilePathstring否用于保存图像的可选路径（根据扩展名选择 png/jpeg）

详细介绍

🎨 Gemini Nanobanana MCP

npm version License: MIT TypeScript Node.js

用 Claude 根据文本生成图像！ 只需输入“画一只可爱的猫”，即可立即获得 AI 生成的图像。

这是一款适合初学者使用的模型上下文协议（MCP）服务，可将 Google 的 Gemini 2.5 Flash 图像生成功能直接带入 Claude 对话中。

快速开始——只需 3 步

1️⃣ 获取 API 密钥（1 分钟）
  1. 访问 Google AI Studio
  2. 登录 Google 账号
  3. 点击“Create API key”→ 复制密钥
2️⃣ 在 Claude 客户端中安装（2 分钟）
Claude Desktop（Windows）
  1. 打开 Notepad
  2. 复制此代码，并将 YOUR_API_KEY 替换为你的实际密钥：
{
  "mcpServers": {
    "gemini-nanobanana-mcp": {
      "command": "npx",
      "args": ["gemini-nanobanana-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
  1. 保存为：%APPDATA%/Claude/claude_desktop_config.json
  2. 重启 Claude Desktop
Claude Desktop（Mac）
  1. 打开 Terminal（在 Spotlight 中搜索“Terminal”）
  2. 运行此命令（替换 YOUR_API_KEY）：
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json << 'EOF'
{
  "mcpServers": {
    "gemini-nanobanana-mcp": {
      "command": "npx",
      "args": ["gemini-nanobanana-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
EOF
  1. 重启 Claude Desktop
Claude Code（最简单！）

只需在终端中运行这一条命令（替换 YOUR_API_KEY）：

claude mcp add gemini-nanobanana-mcp -s user -e GEMINI_API_KEY="YOUR_API_KEY" -- npx -y gemini-nanobanana-mcp@latest
Cursor
  1. 前往 Cursor Settings → MCP → Add new MCP Server
  2. 填写：
    • 名称：gemini-nanobanana-mcp
    • 命令：npx
    • 参数：gemini-nanobanana-mcp@latest
    • 环境变量：GEMINI_API_KEY = YOUR_API_KEY
  3. 重启 Cursor
3️⃣ 开始创作！（0 分钟）

在 Claude 中试试这些提示：

  • “生成一只在花园里玩耍的可爱小狗”
  • “创作一幅山间的美丽日落”
  • “画一辆红色跑车”
  • “创作一幅色彩缤纷的抽象画”

图像会自动保存到 ~/Downloads/gemini-images/

效果展示

基本用法
You: Generate a cozy coffee shop interior
Claude: [Generating image...]
Image generated and saved to: ~/Downloads/gemini-images/generate-2025-01-09-14-30-45.png
Size: 1.2MB | Format: PNG
自定义保存位置
You: Create a sunset landscape and save it as ./my-sunset.png
Claude: Image saved to: ./my-sunset.png

功能介绍

文本生成图像

根据文本描述创作任何你能想象的图像。

示例：

  • "一条威风凛凛的巨龙飞过中世纪城堡"
  • "带有绿植的现代简约风客厅"
  • "鹅卵石街道上的复古自行车"
图像编辑

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

用法：

  • 将图像上传到 Claude
  • 说：“把这张图变成黑白的”
  • 或说：“给这张照片添加日落背景”
图像合成

将多张图像合并为一幅创意作品。

用法：

  • 将 2-10 张图像上传到 Claude
  • 说：“把这些图像合成一张拼贴画”
  • 或说：“以艺术化的方式融合这些照片”
风格迁移

将一张图像的艺术风格应用到另一张图像。

用法：

  • 上传两张图像：一张内容图像和一张风格参考图
  • 说：“将第二张图像的风格应用到第一张图像”

配置选项

环境变量
变量默认值描述
GEMINI_API_KEY必填你的 Google AI Studio API 密钥
AUTO_SAVEtrue未指定路径时自动保存图像
DEFAULT_SAVE_DIR~/Downloads/gemini-images图像的默认保存目录
LOG_LEVELinfo日志级别（error、warn、info、debug）

自定义设置示例：

{
  "mcpServers": {
    "gemini-nanobanana-mcp": {
      "command": "npx",
      "args": ["gemini-nanobanana-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key",
        "AUTO_SAVE": "true",
        "DEFAULT_SAVE_DIR": "~/Pictures/AI-Images",
        "LOG_LEVEL": "debug"
      }
    }
  }
}
禁用自动保存

如需仅在明确请求时保存：

{
  "env": {
    "GEMINI_API_KEY": "your-api-key",
    "AUTO_SAVE": "false"
  }
}

之后，图像只会显示在聊天中，不会保存到磁盘。

即时图像预览（Claude Code）

希望生成图像后自动打开？ 设置 Claude Code 钩子，即可即时通过 Quick Look 预览！

一键设置（Mac）
# Clone this repo and run the installer
git clone https://github.com/nanobanana/nanobanana-mcp.git
cd nanobanana-mcp
bash hooks/install.sh
你将获得
  • 即时预览：生成的图像会自动在 Quick Look 中打开
  • 无需手动操作：不再需要查找并打开文件
  • 智能检测：仅对 nanobanana 图像工具触发
  • 按空格键关闭：使用标准 Quick Look 控件

完整设置指南：hooks/README.md

故障排除

❌ “未设置 GEMINI_API_KEY”错误

解决方法：

  1. 仔细确认你已将 YOUR_API_KEY 替换为实际的 API 密钥
  2. 确保密钥前后没有多余空格
  3. 完全重启 Claude 客户端
  4. 在 Google AI Studio 验证 API 密钥是否可用
“没有此文件或目录”错误

解决方法：

  1. 从 nodejs.org 安装 Node.js（选择 LTS 版本）
  2. 重启终端/Claude 客户端
  3. 再次尝试安装
未生成图像

检查清单：

  • API 密钥是否已正确设置？
  • 网络连接是否正常？
  • 配置后是否重启了 Claude？
  • 尝试一个简单的提示词：“生成一个蓝色圆形”
图像未自动保存

解决方法： 检查配置中是否设有 AUTO_SAVE: "true"（默认行为）。 如果要禁用自动保存，请将其设为 "false"。

钩子设置无效

常见解决方法：

  1. 确保你使用的是 Claude Code（而非 Claude Desktop）
  2. 从 nanobanana-mcp 目录运行安装程序
  3. 安装后重启 Claude Code
  4. 查看 hooks/README.md 了解详细的故障排除方法

更好图像的提示

提示词编写技巧
  • 描述具体：“一只金毛幼犬”，而非“一只狗”
  • 指定风格：“水彩风格”“照片级写实”“卡通风格”
  • 添加细节：“蓝色眼睛”“在阳光明媚的花园里”“戴着红色项圈”
  • 设定氛围：“舒适”“戏剧化”“宁静”“充满活力”
技术细节
  • 支持的格式：PNG、JPEG、WebP、GIF
  • 默认输出：PNG 格式
  • 图像尺寸：兼顾画质与合理的文件大小
  • 速率限制：通过重试逻辑自动管理

🚀 高级功能

🔗 HTTP 模式（用于集成）

以 HTTP 服务而非 stdio 运行：

MCP_TRANSPORT=http MCP_HTTP_PORT=8080 npx gemini-nanobanana-mcp@latest

访问地址：http://localhost:8080/mcp

📊 调试日志

启用详细日志：

{
  "env": {
    "GEMINI_API_KEY": "your-key",
    "LOG_LEVEL": "debug"
  }
}

💡 需要帮助？

🤝 参与贡献

发现了错误？有功能创意？欢迎贡献！

  1. Fork 仓库
  2. 创建功能分支
  3. 进行修改
  4. 提交拉取请求

📄 许可证

MIT License - 欢迎在你自己的项目中使用！

⭐ 如果这对你有帮助，请在 GitHub 上为此仓库点星！

为 Claude 社区倾心打造 ❤️

评论

支持 Markdown

第一次接触 MCP？

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

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