STARWARCLOUD STARWAR.AI
返回市场
双子纳米香蕉主控程序

双子纳米香蕉主控程序

作者：Junhan212 星标更新：2025-09-09
安装使用来源：spider==github.com

项目介绍

🎨 Gemini Nanobanana MCP

npm 版本 许可证: MIT TypeScript Node.js

**使用 Claude 从文本生成图像！**只需键入“画一只可爱的猫”，即可立即获得由 AI 生成的图像。

这是一个面向初学者的模型上下文协议（MCP）服务器，它将 Google 的 Gemini 2.5 Flash 图像生成功能直接带入您的 Claude 对话中。

快速开始 - 只需三步

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

  1. 访问 Google AI Studio
  2. 使用您的 Google 账户登录
  3. 点击“创建 API 密钥”→ 复制密钥

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

<details> <summary><b>Claude 桌面版（Windows）</b></summary>
  1. 打开 记事本
  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 桌面版
</details> <details> <summary><b>Claude 桌面版（Mac）</b></summary>
  1. 打开 终端（在 Spotlight 中搜索“终端”）
  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 桌面版
</details> <details> <summary><b>Claude Code（最简单！）</b></summary>

只需在终端运行以下命令（替换 YOUR_API_KEY）：

claude mcp add gemini-nanobanana-mcp -s user -e GEMINI_API_KEY="YOUR_API_KEY" -- npx -y gemini-nanobanana-mcp@latest
</details> <details> <summary><b>Cursor</b></summary>
  1. 前往 Cursor 设置 → MCP → 添加新 MCP 服务器
  2. 填写：
    • 名称：gemini-nanobanana-mcp
    • 命令：npx
    • 参数：gemini-nanobanana-mcp@latest
    • 环境变量：GEMINI_API_KEY = YOUR_API_KEY
  3. 重启 Cursor
</details>

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
  • 说：“将这些图像组合成拼贴画”
  • 或者：“将这些照片艺术地融合在一起”

风格迁移

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

如何使用：

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

配置选项

<details> <summary><b>环境变量</b></summary>
变量默认值描述
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"
      }
    }
  }
}
</details> <details> <summary><b>禁用自动保存</b></summary>

仅在您明确请求时才保存：

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

然后，图像将仅出现在聊天中而不保存到磁盘。

</details>

即时图像预览（Claude Code）

**希望生成后图像能自动打开吗？**设置 Claude Code 钩子以实现即时 Quick Look 预览！

一键设置（Mac）

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

您将获得

  • 即时预览：生成的图像会自动在 Quick Look 中打开
  • 零手动工作：无需再查找和打开文件
  • 智能检测：仅对 nanobanana 图像工具触发
  • 按空格键关闭：标准 Quick Look 控制

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

故障排除

<details> <summary><b>❌ "GEMINI_API_KEY 未设置" 错误</b></summary>

解决方案：

  1. 再次检查是否用实际 API 密钥替换了 YOUR_API_KEY
  2. 确保密钥周围没有多余的空格
  3. 完全重新启动您的 Claude 客户端
  4. 在 Google AI Studio 上验证您的 API 密钥是否有效
</details> <details> <summary><b>"找不到文件或目录" 错误</b></summary>

解决方案：

  1. 从 nodejs.org 安装 Node.js（选择 LTS 版本）
  2. 重新启动您的终端/Claude 客户端
  3. 再次尝试安装
</details> <details> <summary><b>图像无法生成</b></summary>

检查列表：

  • API 密钥正确设置了吗？
  • 网络连接正常吗？
  • 配置后重启了 Claude 吗？
  • 尝试一个简单的提示：“生成一个蓝色圆圈”
</details> <details> <summary><b>图像未自动保存</b></summary>

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

</details> <details> <summary><b>钩子设置不起作用</b></summary>

常见修复方法：

  1. 确保您使用的是 Claude Code（而不是 Claude 桌面版）
  2. 从 nanobanana-mcp 目录运行安装程序
  3. 安装后重启 Claude Code
  4. 查看 hooks/README.md 以获取详细的故障排除信息
</details>

提升图像质量的小贴士

提示编写技巧

  • 具体："一只金色猎犬幼犬" vs "一只狗"
  • 包含风格："水彩风格"，"摄影真实感"，"卡通风格"
  • 增加细节："蓝眼睛"，"在阳光明媚的花园里"，"戴着红色项圈"
  • 设定氛围："舒适"，"戏剧性"，"宁静"，"充满活力"

技术细节

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

🚀 高级功能

<details> <summary><b>🔗 HTTP 模式（用于集成）</b></summary>

作为 HTTP 服务器运行，而不是 stdio：

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

访问 http://localhost:8080/mcp

</details> <details> <summary><b>📊 调试日志</b></summary>

启用详细日志：

{
  "env": {
    "GEMINI_API_KEY": "your-key",
    "LOG_LEVEL": "debug"
  }
}
</details>

💡 需要帮助？

🤝 贡献

发现了一个错误？有一个功能想法？欢迎贡献！

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

📄 许可证

MIT 许可证 - 欢迎在自己的项目中使用！

⭐ 如果这帮到了您，请在 GitHub 上给这个仓库点赞！

为 Claude 社区打造 ❤️