星战科技xingzhan.cloud
返回市场
纳米香蕉MCP服务器

纳米香蕉MCP服务器

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

项目介绍

Nano-Banana MCP Server 🍌

🤖 该项目完全由 Claude Code 生成 - 一个能够从零开始创建完整的生产就绪应用程序的人工智能编码助手。

这是一个模型上下文协议（MCP）服务器，它使用Google的Gemini 2.5 Flash图像API提供人工智能图像生成和编辑能力。通过简单的文本提示生成令人惊叹的图像，编辑现有图像，并在您的创作上进行迭代。

<a href="https://glama.ai/mcp/servers/@ConechoAI/Nano-Banana-MCP"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=3158627144,920418114&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Nano-Banana-MCP MCP服务器" /> </a>

✨ 特性

  • 🎨 生成图像：根据文本描述创建新图像
  • ✏️ 编辑图像：使用文本提示修改现有图像
  • 🔄 迭代编辑：继续编辑最后生成或编辑的图像
  • 🖼️ 多个参考图像：使用参考图像进行风格转移和指导
  • 🌍 跨平台：适用于Windows、macOS和Linux的智能文件路径
  • 🔧 简单设置：通过API密钥进行简单配置
  • 📁 自动文件管理：自动保存图像并命名有序

🔑 设置

  1. 获取您的Gemini API密钥：

    • 访问 Google AI Studio
    • 创建一个新的API密钥
    • 复制它以供配置使用

  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"]
    }
  }
}

使用示例：

生成一幅夕阳照耀山峦的图像

编辑这张图像，在天空中添加一些鸟

继续编辑，使其更加戏剧化

🎯 使用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：使用配置工具

npx nano-banana-mcp
# 当首次使用时，服务器会提示您进行配置
# 这会在当前目录下创建一个本地的 .nano-banana-config.json 文件

🛠️ 可用命令

generate_image

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

generate_image({
  prompt: "一座夜晚霓虹灯闪烁的未来城市"
})

edit_image

编辑特定的图像文件。

edit_image({
  imagePath: "/path/to/image.png",
  prompt: "在天空中添加一道彩虹",
  referenceImages?: ["/path/to/reference.jpg"] // 可选
})

continue_editing

继续编辑最后生成或编辑的图像。

continue_editing({
  prompt: "让它更丰富多彩",
  referenceImages?: ["/path/to/style.jpg"] // 可选
})

get_last_image_info

获取关于最后生成图像的信息。

get_last_image_info()

configure_gemini_token

配置您的Gemini API密钥。

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

get_configuration_status

检查是否已配置API密钥。

get_configuration_status()

⚙️ 配置优先级

MCP服务器按照以下优先级加载您的API密钥：

  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-[时间戳]-[ID].png
  • 编辑的图像：edited-[时间戳]-[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 - 架构验证
  • Google GenAI - 图像生成API
  • MCP SDK - 模型上下文协议

本地开发

# 克隆仓库
git clone https://github.com/claude-code/nano-banana-mcp.git
cd nano-banana-mcp

# 安装依赖
npm install

# 开发模式运行
npm run dev

# 生产构建
npm run build

# 运行测试
npm test

📋 要求

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

🤝 贡献

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

  • 报告错误
  • 建议新功能
  • 提交拉取请求
  • 改进文档

📄 许可证

MIT许可证 - 详情见LICENSE文件。

🙏 致谢

  • Claude Code - 生成整个项目
  • Google AI - 强大的Gemini 2.5 Flash图像API
  • Anthropic - 模型上下文协议
  • 开源社区 - 提供了惊人的工具和库

📞 支持

✨ 由 Claude Code 深情生成 - 人工智能驱动开发的未来已经到来！