Nano Banana MCP

🚀 納米香蕉MCP服務器 🍌

這是一個模型上下文協議（MCP）服務器，藉助谷歌的Gemini 2.5 Flash圖像API，提供AI圖像生成與編輯功能。你只需通過簡單的文本提示，就能生成令人驚豔的圖像、編輯現有圖像，並不斷完善你的創作。

🚀 快速開始

🔑 配置步驟

1. 獲取Gemini API密鑰：
   • 訪問 Google AI Studio。
   • 創建一個新的API密鑰。
   • 複製該密鑰用於後續配置。
2. 配置MCP服務器： 參考以下針對特定客戶端（Claude Code、Cursor或其他MCP客戶端）的配置示例。

✨ 主要特性

• 🎨 圖像生成：根據文本描述創建新圖像。
• ✏️ 圖像編輯：通過文本提示修改現有圖像。
• 🔄 迭代編輯：繼續對最後生成/編輯的圖像進行修改。
• 🖼️ 多參考圖像：使用參考圖像進行風格遷移和引導。
• 🌍 跨平臺支持：支持Windows、macOS和Linux系統的智能文件路徑。
• 🔧 輕鬆設置：使用API密鑰即可輕鬆完成配置。
• 📁 自動文件管理：自動保存圖像並進行有序命名。

📦 安裝指南

🔑 獲取Gemini API密鑰

1. 訪問 Google AI Studio。
2. 創建一個新的API密鑰。
3. 複製該密鑰用於後續配置。

🔧 配置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"]
  }
}

🔧 其他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
# 首次使用時，服務器會提示你進行配置
# 這將在當前目錄下創建一個.local.nano-banana-config.json文件

💻 使用示例

💻 使用Claude Code

配置示例

見上文“使用Claude Code”部分的配置內容。

使用示例

生成一幅山脈上日落的圖像

編輯這幅圖像，在天空中添加一些鳥

繼續編輯，讓它更有戲劇性

🎯 使用Cursor

配置示例

見上文“使用Cursor”部分的配置內容。

使用示例

• 讓Cursor為你的應用生成圖像。
• 創建模型和原型。
• 為你的項目生成資源。

🔧 其他MCP客戶端

配置方法

見上文“其他MCP客戶端”部分的配置內容。

🔧 可用命令

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 - 提供模型上下文協議。
• 開源社區 - 提供了出色的工具和庫。

📞 支持

• 🐛 問題反饋：GitHub Issues
• 📖 文檔：本README和代碼內註釋。
• 💬 討論：GitHub Discussions

✨ 由 Claude Code 用心生成 - AI驅動開發的未來已來！