AI导哈

文本转图像生成工具

Gemini Nanobanana MCP 是一个基于 Google Gemini 2.5 Flash 的文本转图像生成工具，通过 Claude 对话界面提供 AI 图像生成、编辑、合成和风格转换功能，适用于创意设计、内容创作等场景。

  • by Junhan2
  • JavaScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 Junhan2/gemini-nanobanana-mcp

使用说明

🎨 双子纳米香蕉MCP

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

一个初学者友好的模型上下文协议（MCP）服务器，将谷歌的Gemini 2.5 Flash图像生成直接带入您的克劳德对话中。

快速入门-只需3步

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

  1. 访问 谷歌人工智能工作室
  2. 使用您的Google帐户登录
  3. 点击“创建API密钥”→ 复制密钥

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

Claude Desktop (Windows)
  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 Desktop (Mac)
  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 Code (Easiest!)

只需在终端中运行此命令（替换 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. 重新启动游标

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

在克劳德身上试试这些：

  • “在花园里养一只可爱的小狗”
  • “在山上创造美丽的日落”
  • “画一辆红色跑车”
  • “做一幅抽象的彩色画”

您的图像会自动保存到 ~/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

你能做什么

文本到图像生成

根据文本描述创建您可以想象的任何图像。

示例：

  • "A majestic dragon flying over a medieval castle"
  • "Modern minimalist living room with plants"
  • "Vintage bicycle on a cobblestone street"

图像编辑

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

如何使用：

  • 上传图片给Claude
  • 说： "Make this image black and white"
  • 或者： "Add a sunset background to this photo"

图像合成

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

如何使用：

  • 上传2-10张图片给Claude
  • 说： "Combine these images into a collage"
  • 或者： "Blend these photos together artistically"

风格迁移

将一个图像的艺术风格应用于另一个图像。

如何使用：

  • 上传两张图片：内容图片和样式参考
  • 说： "Apply the style of the second image to the first"

配置选项

Environment Variables
变量 默认值 描述
GEMINI_API_KEY 必需 您的Google AI Studio API密钥
AUTO_SAVE true 未指定路径时自动保存图像
DEFAULT_SAVE_DIR ~/Downloads/gemini-images 保存图像的默认目录
LOG_LEVEL info 日志记录级别(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"
      }
    }
  }
}
Disable Auto-Save

要仅在您明确请求时保存，请执行以下操作：

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

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

即时图像预览（Claude代码）

想要图像生成后自动打开吗？ 设置Claude Code挂钩，实现即时快速浏览预览！

一键设置（Mac）

# Clone this repo and run the installer
git clone https://github.com/nanobanana/nanobanana-mcp.git
cd nanobanana-mcp
bash hooks/install.sh

所得

  • 谷歌搜索结果预览功能：生成的图像在快速浏览中自动打开
  • 零人工操作：不再查找和打开文件
  • 智能检测：仅适用于nanobanana图像工具的触发器
  • 按空格键关闭：标准快速浏览控件

完整设置指南: 钩子/README.md

故障排除

❌ "GEMINI_API_KEY not set" error

解决方案：

  1. 仔细检查您是否更换了 YOUR_API_KEY 使用您的实际API密钥
  2. 确保钥匙周围没有多余的空格
  3. 完全重新启动您的Claude客户端
  4. 验证您的API密钥在 谷歌人工智能工作室
"No such file or directory" error

解决方案：

  1. 从以下位置安装Node.js nodejs.org （选择LTS版本）
  2. 重新启动终端/Claude客户端
  3. 请重试安装
Images not generating

检查表：

  • API密钥设置正确？
  • 互联网连接正常吗？
  • 配置后重新启动Claude？
  • 尝试一个简单的提示：“生成一个蓝色圆圈”
Images not saving automatically

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

Hook setup not working

常见修复：

  1. 确保您使用的是Claude Code（而不是Claude Desktop）
  2. 从nanobanana mcp目录运行安装程序
  3. 安装后重新启动Claude Code
  4. 检查 钩子/README.md 详细故障排除

获得更好图像的提示

快速写作技巧

  • 要具体：“一只金毛寻回犬小狗”vs“一只狗”
  • 包括样式：“水彩风格”、“照片级真实感”、“卡通风格”
  • 添加详细信息：“蓝眼睛”、“在阳光明媚的花园里”、“戴着红领”
  • 调节情绪：“舒适”、“戏剧性”、“宁静”、“充满活力”

技术细节

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

🚀 高级功能

🔗 HTTP Mode (for integrations)

以HTTP服务器而不是stdio运行：

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

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

📊 Debug Logging

启用详细日志记录：

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

💡 需要帮助？

🤝 贡献

发现bug了吗？有一个功能想法吗？欢迎投稿！

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

📄 许可证

MIT许可证-您可以在自己的项目中自由使用！

⭐ 如果这对你有帮助，请在GitHub上标记存储库！

内置于❤️ 为克劳德社区

相关 MCP