Gemini Nanobanana MCP

🚀 🎨 Gemini Nanobanana MCP

Gemini Nanobanana MCP 是一个对初学者友好的模型上下文协议（MCP）服务器，它能将 Google 的 Gemini 2.5 Flash 图像生成功能直接集成到你的 Claude 对话中。你只需输入文本，如“画一只可爱的猫”，就能立即获得 AI 生成的图像。

🚀 快速开始

1️⃣ 获取 API 密钥（1 分钟）

1. 访问 Google AI Studio。
2. 使用你的 Google 账户登录。
3. 点击“创建 API 密钥”，然后复制该密钥。

2️⃣ 在你的 Claude 客户端中安装（2 分钟）

{
  "mcpServers": {
    "gemini-nanobanana-mcp": {
      "command": "npx",
      "args": ["gemini-nanobanana-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "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

claude mcp add gemini-nanobanana-mcp -s user -e GEMINI_API_KEY="YOUR_API_KEY" -- npx -y gemini-nanobanana-mcp@latest

3️⃣ 开始创作！（0 分钟）

在 Claude 中尝试以下内容：

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

你的图像将自动保存到 ~/Downloads/gemini-images/

💻 使用示例

基础用法

你：生成一个温馨的咖啡店内部场景
Claude：[正在生成图像...]
图像已生成并保存到：~/Downloads/gemini-images/generate-2025-01-09-14-30-45.png
大小：1.2MB | 格式：PNG

自定义保存位置

你：创建一幅日落风景图并保存为 ./my-sunset.png
Claude：图像已保存到：./my-sunset.png

✨ 主要特性

文本到图像生成

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

示例：

• "一只威严的龙飞过中世纪城堡"
• "带有植物的现代简约客厅"
• "鹅卵石街道上的复古自行车"

图像编辑

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

使用方法：

• 将图像上传到 Claude。
• 说："将这张图像转换为黑白图像"
• 或者："为这张照片添加日落背景"

图像合成

将多张图像组合成一个创意作品。

使用方法：

• 将 2 - 10 张图像上传到 Claude。
• 说："将这些图像组合成一幅拼贴画"
• 或者："艺术地融合这些照片"

风格迁移

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

使用方法：

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

📦 安装指南

环境变量

自定义设置示例：

{
  "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 钩子以实现即时快速查看预览！

一键设置（Mac）

# 克隆此仓库并运行安装程序
git clone https://github.com/nanobanana/nanobanana-mcp.git
cd nanobanana-mcp
bash hooks/install.sh

你将获得

• 即时预览：生成的图像将自动在快速查看中打开。
• 无需手动操作：无需再手动查找和打开文件。
• 智能检测：仅对 nanobanana 图像工具触发。
• 按空格键关闭：使用标准的快速查看控件。

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

故障排除

生成更好图像的提示

提示编写技巧

• 具体描述：例如，“一只金毛猎犬幼犬” 比 “一只狗” 更具体。
• 包含风格：如 “水彩风格”、“写实风格”、“卡通风格”。
• 添加细节：如 “蓝色眼睛”、“阳光明媚的花园里”、“戴着红色项圈”。
• 设定氛围：如 “温馨的”、“戏剧性的”、“宁静的”、“充满活力的”。

技术细节

• 支持的格式：PNG、JPEG、WebP、GIF。
• 默认输出：PNG 格式。
• 图像大小：针对质量和合理的文件大小进行了优化。
• 速率限制：通过重试逻辑自动管理。

🔧 技术细节

高级功能

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

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

💡 需要帮助？

• 📖 快速设置指南：QUICK_START.md
• 🪝 自动预览设置：hooks/README.md
• 🐛 报告问题：GitHub Issues
• 💬 功能请求：欢迎提出！

🤝 贡献

如果你发现了错误或有功能建议，欢迎贡献代码！

1. 分叉仓库。
2. 创建你的功能分支。
3. 进行更改。
4. 提交拉取请求。

📄 许可证

本项目采用 MIT 许可证，你可以在自己的项目中自由使用！

⭐ 如果这个项目对你有帮助，请在 GitHub 上给仓库加星！

为 Claude 社区用心打造