🎨 双子纳米香蕉MCP
](https://www.npmjs.com/package/gemini-nanobanana-mcp)   ](https://nodejs.org/)
使用Claude从文本生成图像！ 只需输入“画一只可爱的猫”，即可获得即时AI生成的图像。
一个初学者友好的模型上下文协议（MCP）服务器，将谷歌的Gemini 2.5 Flash图像生成直接带入您的克劳德对话中。
快速入门-只需3步
1.️⃣ 获取API密钥（1分钟）
- 访问 谷歌人工智能工作室
- 使用您的Google帐户登录
- 点击“创建API密钥”→ 复制密钥
2.️⃣ 在您的Claude客户端中安装（2分钟）
Claude Desktop (Windows)
- 打开 记事本
- 复制此代码并替换
YOUR_API_KEY使用您的实际密钥：
{
"mcpServers": {
"gemini-nanobanana-mcp": {
"command": "npx",
"args": ["gemini-nanobanana-mcp@latest"],
"env": {
"GEMINI_API_KEY": "YOUR_API_KEY"
}
}
}
}- 另存为：
%APPDATA%/Claude/claude_desktop_config.json - 重新启动克劳德桌面
Claude Desktop (Mac)
- 打开 终端 （在Spotlight中搜索“终端”）
- 运行此命令（替换
YOUR_API_KEY):
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json
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`
1. 填写：
- **名字**: `gemini-nanobanana-mcp`
- **命令**: `npx`
- **参数**: `gemini-nanobanana-mcp@latest`
- **环境变量**: `GEMINI_API_KEY` = `YOUR_API_KEY`
1. **重新启动游标**
### 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](hooks/README.md)
______________________________________________________________________
## 故障排除
❌ "GEMINI_API_KEY not set" error
**解决方案：**
1. 仔细检查您是否更换了 `YOUR_API_KEY` 使用您的实际API密钥
1. 确保钥匙周围没有多余的空格
1. 完全重新启动您的Claude客户端
1. 验证您的API密钥在 [谷歌人工智能工作室](https://aistudio.google.com/)
"No such file or directory" error
**解决方案：**
1. 从以下位置安装Node.js （选择LTS版本）
1. 重新启动终端/Claude客户端
1. 请重试安装
Images not generating
**检查表：**
- API密钥设置正确？
- 互联网连接正常吗？
- 配置后重新启动Claude？
- 尝试一个简单的提示：“生成一个蓝色圆圈”
Images not saving automatically
**解决方案：**
检查您的配置是否 `AUTO_SAVE: "true"` （默认行为）。
如果要禁用自动保存，请将其设置为 `"false"`.
Hook setup not working
**常见修复：**
1. 确保您使用的是Claude Code（而不是Claude Desktop）
1. 从nanobanana mcp目录运行安装程序
1. 安装后重新启动Claude Code
1. 检查 [钩子/README.md](hooks/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" } }
______________________________________________________________________
## 💡 需要帮助？
- 📖 **快速设置指南**: [快速启动.md](QUICK_START.md)
- 🪝 **自动预览设置**: [钩子/README.md](hooks/README.md)
- 🐛 **报告问题**:
- 💬 **功能请求**：欢迎！
______________________________________________________________________
## 🤝 贡献
发现bug了吗？有一个功能想法吗？欢迎投稿！
1. 分叉存储库
1. 创建功能分支
1. 进行更改
1. 提交拉取请求
______________________________________________________________________
## 📄 许可证
MIT许可证-您可以在自己的项目中自由使用！
______________________________________________________________________
**⭐ 如果这对你有帮助，请在GitHub上标记存储库！**
*内置于❤️ 为克劳德社区*