MCP Nano Banana

🚀 MCP Nano Banana

MCP Nano Banana是一個基於MCP（模型上下文協議）的服務器項目，它藉助Google Gemini API來生成圖像，為AI模型提供了便捷的圖像生成能力。

🚀 快速開始

若要使用此服務器與Claude Desktop或其他應用協同工作，你需要獲取Google Gemini API密鑰和ImgBB API密鑰。

• 訪問 ImgBB API 生成IMGBB API密鑰，該密鑰用於在線存儲和託管圖像。
• 配置相關信息，示例如下：

{
  "mcpServers": {
    "mcp-nano-banana": {
        "command": "uvx",
        "args": [
            "mcp-nano-banana"
        ],
        "env": {
            "GEMINI_API_KEY": "YOUR_API_KEY_HERE",
            "IMGBB_API_KEY": "YOUR_API_KEY_HERE"
        }
    }
  }
}

✨ 主要特性

此服務器實現了模型上下文協議，向兼容的AI模型公開了一個名為 generate_image 的工具。該工具接收文本提示，通過Google Gemini API生成圖像，將圖像保存到 public/ 目錄以便審核，並以Base64編碼的字符串形式返回原始圖像數據。

📦 安裝指南

1. 依賴安裝

本項目使用Python，其依賴項在 pyproject.toml 中定義。你可以使用 pip 進行安裝：

pip install .
# 或者
uv sync

這將安裝 mcp、google-generativeai 等所需的包。

2. API密鑰配置

你需要Google Gemini API密鑰和ImgBB API密鑰才能使用此服務器。

• 訪問 ImgBB API 生成IMGBB API密鑰，用於在線存儲和託管圖像。
• 在項目根目錄下創建一個名為 .env 的文件。
• 按以下格式將API密鑰添加到 .env 文件中：

GEMINI_API_KEY="YOUR_API_KEY_HERE"
IMGBB_API_KEY="YOUR_API_KEY_HERE"

💻 使用示例

運行服務器

此服務器設計為由MCP客戶端作為子進程運行，或使用 mcp 命令行工具運行。服務器通過 stdio 監聽請求。

uvx --from git+https://github.com/GuilhermeAumo/mcp-nano-banana mcp-nano-banana

📚 詳細文檔

發佈新的Pipy版本

若要將此包的新版本發佈到PyPI，請按以下步驟操作：

1. 更新版本號：編輯 pyproject.toml 中的 version 字段，將其更新為新的版本號。
2. 構建包：運行以下命令，這將在 dist/ 目錄下創建 .tar.gz 和 .whl 文件。

uv build

3. 上傳到PyPI：

uv publish

4. 標記版本（可選但推薦）：先將更改提交到GitHub，然後執行以下命令：

git tag v<new-version>
git push --tags

注意：你需要擁有PyPI賬戶，並且必須是該項目的維護者之一。更多詳細信息，請參閱 Python打包用戶指南。