Gemini Nanobanana MCP

🚀 🎨 Gemini Nanobanana MCP

Gemini Nanobanana MCP 是一個對初學者友好的模型上下文協議（MCP）服務器，它能將 Google 的 Gemini 2.5 Flash 圖像生成功能直接集成到你的 Claude 對話中。你只需輸入文本，如“畫一隻可愛的貓”，就能立即獲得 AI 生成的圖像。

🚀 快速開始

1️⃣ 獲取 API 密鑰（1 分鐘）

1. 訪問 Google AI Studio。
2. 使用你的 Google 賬戶登錄。
3. 點擊“創建 API 密鑰”，然後複製該密鑰。

2️⃣ 在你的 Claude 客戶端中安裝（2 分鐘）

{
  "mcpServers": {
    "gemini-nanobanana-mcp": {
      "command": "npx",
      "args": ["gemini-nanobanana-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "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

claude mcp add gemini-nanobanana-mcp -s user -e GEMINI_API_KEY="YOUR_API_KEY" -- npx -y gemini-nanobanana-mcp@latest

3️⃣ 開始創作！（0 分鐘）

在 Claude 中嘗試以下內容：

• “生成一隻在花園裡玩耍的可愛小狗”
• “創建一幅美麗的山間日落圖”
• “畫一輛紅色跑車”
• “製作一幅抽象的彩色畫作”

你的圖像將自動保存到 ~/Downloads/gemini-images/

💻 使用示例

基礎用法

你：生成一個溫馨的咖啡店內部場景
Claude：[正在生成圖像...]
圖像已生成並保存到：~/Downloads/gemini-images/generate-2025-01-09-14-30-45.png
大小：1.2MB | 格式：PNG

自定義保存位置

你：創建一幅日落風景圖並保存為 ./my-sunset.png
Claude：圖像已保存到：./my-sunset.png

✨ 主要特性

文本到圖像生成

根據文本描述創建任何你能想象到的圖像。

示例：

• "一隻威嚴的龍飛過中世紀城堡"
• "帶有植物的現代簡約客廳"
• "鵝卵石街道上的復古自行車"

圖像編輯

使用自然語言指令編輯現有圖像。

使用方法：

• 將圖像上傳到 Claude。
• 說："將這張圖像轉換為黑白圖像"
• 或者："為這張照片添加日落背景"

圖像合成

將多張圖像組合成一個創意作品。

使用方法：

• 將 2 - 10 張圖像上傳到 Claude。
• 說："將這些圖像組合成一幅拼貼畫"
• 或者："藝術地融合這些照片"

風格遷移

將一幅圖像的藝術風格應用到另一幅圖像上。

使用方法：

• 上傳兩張圖像：一張內容圖像和一張風格參考圖像。
• 說："將第二張圖像的風格應用到第一張圖像上"

📦 安裝指南

環境變量

自定義設置示例：

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

禁用自動保存

若只想在明確請求時保存圖像：

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

這樣，圖像將僅顯示在聊天中，而不會保存到磁盤。

📚 詳細文檔

即時圖像預覽（Claude Code）

想在圖像生成後自動打開嗎？ 設置 Claude Code 鉤子以實現即時快速查看預覽！

一鍵設置（Mac）

# 克隆此倉庫並運行安裝程序
git clone https://github.com/nanobanana/nanobanana-mcp.git
cd nanobanana-mcp
bash hooks/install.sh

你將獲得

• 即時預覽：生成的圖像將自動在快速查看中打開。
• 無需手動操作：無需再手動查找和打開文件。
• 智能檢測：僅對 nanobanana 圖像工具觸發。
• 按空格鍵關閉：使用標準的快速查看控件。

完整設置指南：hooks/README.md

故障排除

生成更好圖像的提示

提示編寫技巧

• 具體描述：例如，“一隻金毛獵犬幼犬” 比 “一隻狗” 更具體。
• 包含風格：如 “水彩風格”、“寫實風格”、“卡通風格”。
• 添加細節：如 “藍色眼睛”、“陽光明媚的花園裡”、“戴著紅色項圈”。
• 設定氛圍：如 “溫馨的”、“戲劇性的”、“寧靜的”、“充滿活力的”。

技術細節

• 支持的格式：PNG、JPEG、WebP、GIF。
• 默認輸出：PNG 格式。
• 圖像大小：針對質量和合理的文件大小進行了優化。
• 速率限制：通過重試邏輯自動管理。

🔧 技術細節

高級功能

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

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

💡 需要幫助？

• 📖 快速設置指南：QUICK_START.md
• 🪝 自動預覽設置：hooks/README.md
• 🐛 報告問題：GitHub Issues
• 💬 功能請求：歡迎提出！

🤝 貢獻

如果你發現了錯誤或有功能建議，歡迎貢獻代碼！

1. 分叉倉庫。
2. 創建你的功能分支。
3. 進行更改。
4. 提交拉取請求。

📄 許可證

本項目採用 MIT 許可證，你可以在自己的項目中自由使用！

⭐ 如果這個項目對你有幫助，請在 GitHub 上給倉庫加星！

為 Claude 社區用心打造