Banana Image MCP

🚀 香蕉圖像MCP

香蕉圖像MCP是一個基於MCP（模型上下文協議）的服務器，它能讓Claude等AI助手藉助谷歌最新的Gemini圖像模型生成高質量圖像。你只需描述需求，Claude就能從快速概念草圖到驚豔的4K專業藝術作品，滿足你的多樣創作需求。

🚀 快速開始

在不到2分鐘的時間內啟動並運行。

前提條件

• 從 Google AI Studio 獲取一個免費的Gemini API密鑰。
• 安裝 Claude Desktop。

安裝

添加到你的Claude Desktop配置文件中：

{
  "mcpServers": {
    "banana-image": {
      "command": "uvx",
      "args": ["banana-image-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

# 清除此包的緩存
uv cache clean banana-image-mcp

# 然後重啟Claude Desktop

"args": ["banana-image-mcp==1.0.1"]

✨ 主要特性

4K超高清輸出

專業版模型可生成高達 3840px 的圖像，非常適合專業工作、營銷材料和印刷品。

雙模型支持

• 快速版：2 - 3秒，最高1024px，適用於快速迭代。
• 專業版：5 - 8秒，最高4K，適用於最終交付物。

智能模型選擇

服務器會根據你的提示自動選擇最佳模型。說“快速草圖”使用快速版，說“4K專業”使用專業版。

谷歌搜索知識融合

專業版模型利用谷歌搜索的真實世界知識生成更準確、符合事實的圖像。

靈活的縱橫比

支持所有常見比例：1:1、16:9、9:16、4:3、3:2、21:9 等。

自然語言編輯

使用簡單的文本命令（如“讓天空更有戲劇性”或“去除背景”）編輯現有圖像。

📦 安裝指南

見快速開始部分的安裝步驟。

💻 使用示例

基礎用法

只需自然地要求Claude生成圖像：

"生成一隻穿著宇航服的可愛貓咪"
"創建一張4K質量的咖啡杯專業產品照片"
"製作一個16:9的烹飪主題YouTube縮略圖"
"編輯這張圖片：讓天空更有戲劇性"

模型比較

服務器默認使用專業版模型以獲得最佳質量。可以使用關鍵詞控制：

參數參考

環境變量

📚 詳細文檔

可創作內容

路線圖

• [x] 4K分辨率輸出（最高3840px）
• [x] 雙模型支持（快速版 + 專業版）
• [x] 谷歌搜索知識融合
• [x] 靈活的縱橫比
• [x] 自然語言圖像編輯
• [x] GitHub Actions CI/CD
• [ ] 批量圖像生成
• [ ] 圖像到圖像轉換
• [ ] 視頻生成支持
• [ ] 本地模型支持（Ollama）

查看 開放問題 以獲取完整的提議功能和已知問題列表。

🔧 技術細節

開發

# 克隆倉庫
git clone https://github.com/zengwenliang416/banana-image-mcp.git
cd banana-image-mcp

# 安裝依賴
uv sync

# 在開發模式下運行
fastmcp dev banana_image_mcp.server:create_app

# 運行測試
pytest

# 代碼檢查和格式化
ruff check .
ruff format .

📄 許可證

本項目採用MIT許可證進行分發。有關更多信息，請參閱 LICENSE 文件。

聯繫我們

曾文亮 - @zengwenliang416

項目鏈接: https://github.com/zengwenliang416/banana-image-mcp

致謝

• FastMCP - 為該服務器提供支持的MCP框架。
• Google Gemini - 圖像生成背後的AI模型。
• Anthropic MCP - 協議規範。
• Best-README-Template - README靈感來源。