Nano Banana Mcp

Nano-Banana MCP 服务 🍌

🤖 本项目完全由 Claude Code 生成——一个可以从零开始创建完整、可投入生产应用的 AI 编码助手。

一个 Model Context Protocol (MCP) 服务，使用 Google 的 Gemini 2.5 Flash Image API 提供 AI 图像生成和编辑能力。通过简单的文本提示词生成惊艳的图像、编辑现有图像，并持续迭代你的创作。

✨ 功能

• 🎨 生成图像：根据文本描述创建新图像
• ✏️ 编辑图像：使用文本提示词修改现有图像
• 🔄 迭代编辑：继续编辑上一次生成/编辑的图像
• 🖼️ 多张参考图像：使用参考图像进行风格迁移和引导
• 🌍 跨平台：为 Windows、macOS 和 Linux 提供智能文件路径
• 🔧 轻松设置：使用 API key 进行简单配置
• 📁 自动文件管理：自动保存图像并采用有序命名

🔑 设置

1. 获取你的 Gemini API key：

   • 访问 Google AI Studio
   • 创建一个新的 API key
   • 复制它以便进行配置

2. 配置 MCP 服务： 请参阅下方针对你特定客户端（Claude Code、Cursor 或其他 MCP 客户端）的配置示例。

💻 在 Claude Code 中使用

配置：

将以下内容添加到你的 Claude Code MCP 设置中：

选项 A：使用环境变量（推荐——最安全）

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["nano-banana-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    }
  }
}

选项 B：不使用环境变量

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["nano-banana-mcp"]
    }
  }
}

使用示例：

Generate an image of a sunset over mountains

Edit this image to add some birds in the sky

Continue editing to make it more dramatic

🎯 在 Cursor 中使用

配置：

添加到你的 Cursor MCP 配置中：

选项 A：使用环境变量（推荐）

{
  "nano-banana": {
    "command": "npx",
    "args": ["nano-banana-mcp"],
    "env": {
      "GEMINI_API_KEY": "your-gemini-api-key-here"
    }
  }
}

选项 B：不使用环境变量

{
  "nano-banana": {
    "command": "npx",
    "args": ["nano-banana-mcp"]
  }
}

使用示例：

• 让 Cursor 为你的应用生成图像
• 创建模型图和原型
• 为你的项目生成素材

🔧 适用于其他 MCP 客户端

如果你使用的是其他 MCP 客户端，可以使用以下任意方法配置 nano-banana-mcp：

配置方法

方法 A：在 MCP 配置中使用环境变量（推荐）

{
  "nano-banana": {
    "command": "npx",
    "args": ["nano-banana-mcp"],
    "env": {
      "GEMINI_API_KEY": "your-gemini-api-key-here"
    }
  }
}

方法 B：系统环境变量

export GEMINI_API_KEY="your-gemini-api-key-here"
npx nano-banana-mcp

方法 C：使用 Configure 工具

npx nano-banana-mcp
# The server will prompt you to configure when first used
# This creates a local .nano-banana-config.json file

🛠️ 可用命令

generate_image

根据文本提示词创建新图像。

generate_image({
  prompt: "A futuristic city at night with neon lights"
})

edit_image

编辑特定的图像文件。

edit_image({
  imagePath: "/path/to/image.png",
  prompt: "Add a rainbow in the sky",
  referenceImages?: ["/path/to/reference.jpg"] // optional
})

continue_editing

继续编辑上一次生成/编辑的图像。

continue_editing({
  prompt: "Make it more colorful",
  referenceImages?: ["/path/to/style.jpg"] // optional
})

get_last_image_info

获取上一次生成图像的信息。

get_last_image_info()

configure_gemini_token

配置你的 Gemini API key。

configure_gemini_token({
  apiKey: "your-gemini-api-key"
})

get_configuration_status

检查 API key 是否已配置。

get_configuration_status()

⚙️ 配置优先级

MCP 服务按以下优先级顺序加载你的 API key：

1. 🥇 MCP 配置环境变量（最高优先级）

   • 在你的 claude_desktop_config.json 或 MCP 客户端配置中设置
   • 最安全，因为它包含在 MCP 配置中
   • 示例："env": { "GEMINI_API_KEY": "your-key" }

2. 🥈 系统环境变量

   • 在你的 shell/系统环境中设置
   • 示例：export GEMINI_API_KEY="your-key"

3. 🥉 本地配置文件（最低优先级）

   • 在使用 configure_gemini_token 工具时创建
   • 以 .nano-banana-config.json 形式存储在当前目录中
   • 会被 Git 和 NPM 自动忽略

💡 建议：使用方法 1（MCP 配置环境变量）以获得最佳的安全性和便利性。

📁 文件存储

图片会自动保存到适合平台的位置：

• Windows：%USERPROFILE%\\Documents\\nano-banana-images\\
• macOS/Linux：./generated_imgs/（位于当前目录）
• 系统目录：~/nano-banana-images/（从系统路径运行时）

文件命名约定：

• 生成的图片：generated-[timestamp]-[id].png
• 编辑过的图片：edited-[timestamp]-[id].png

🎨 工作流示例

基础图片生成

1. generate_image - 创建你的基础图片
2. continue_editing - 优化和改进
3. continue_editing - 添加最后的润色

风格迁移

1. generate_image - 创建基础内容
2. edit_image - 使用参考图片设定风格
3. continue_editing - 微调结果

迭代设计

1. generate_image - 从一个概念开始
2. get_last_image_info - 检查当前状态
3. continue_editing - 进行调整
4. 重复直到满意

🔧 开发

本项目由 Claude Code 创建，并采用以下技术：

• TypeScript - 类型安全的开发
• Node.js - 运行时环境
• Zod - Schema 验证
• Google GenAI - 图片生成 API
• MCP SDK - Model Context Protocol

本地开发

# Clone the repository
git clone https://github.com/claude-code/nano-banana-mcp.git
cd nano-banana-mcp

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npm test

📋 要求

• Node.js 18.0.0 或更高版本
• 来自 Google AI Studio 的 Gemini API 密钥
• 兼容 Claude Code、Cursor 和其他 MCP 客户端

🤝 贡献

本项目由 Claude Code 生成，但欢迎贡献！请随时：

• 报告 bug
• 建议新功能
• 提交 pull request
• 改进文档

📄 许可证

MIT License - 详情请参阅 LICENSE 文件。

🙏 致谢

• Claude Code - 生成了这整个项目
• Google AI - 提供了强大的 Gemini 2.5 Flash Image API
• Anthropic - 提供了 Model Context Protocol
• 开源社区 - 提供了出色的工具和库

📞 支持

• 🐛 Issues：GitHub Issues
• 📖 文档：本 README 和代码内联注释
• 💬 讨论：GitHub Discussions

---

✨ 由 Claude Code 用爱生成 - AI 驱动开发的未来已经到来！