Gemini Image MCP Server

🚀 Gemini 圖像 MCP 服務器

基於 Google Gemini 的圖像生成和編輯服務，通過 MCP 協議提供 AI 圖像處理功能，為用戶帶來便捷的圖像生成與編輯體驗。

🚀 快速開始

本項目是基於 Google Gemini 的圖像生成和編輯服務，藉助 MCP 協議實現強大的 AI 圖像處理功能。以下將為你介紹其功能特點、安裝運行步驟、API 文檔以及 MCP 配置等內容。

✨ 主要特性

• 文本轉圖像生成 (generate_image)：可根據輸入的提示語生成對應的圖像。
• 圖像編輯與修改 (edit_image)：支持對已有圖像進行編輯和修改。
• 支持 PNG 格式：方便用戶處理和使用生成的圖像。
• 自動化文件路徑管理：讓文件管理更加便捷。

📦 安裝指南

安裝依賴

# 安裝依賴
uv pip install -r requirements.txt

設置環境變量

Linux/macOS

export GEMINI_API_KEY=your_api_key_here

Windows

setx GEMINI_API_KEY "your_api_key_here"

💻 使用示例

基礎用法

生成圖像

@mcp.tool()
async def generate_image(prompt: str, save_path: str = None) -> str:
    """
    :param prompt: 圖像生成提示語（英文效果更佳）
    :param save_path: 可選保存路徑（默認：generated-images/ 目錄）
    :return: 生成圖像的絕對路徑
    """

編輯圖像

@mcp.tool()
async def edit_image(prompt: str, image_path: str, save_path: str = None) -> str:
    """
    :param prompt: 圖像編輯指令（支持中文）
    :param image_path: 原始圖片路徑
    :param save_path: 可選保存路徑，默認生成在 generated-images/ 目錄
    :return: 編輯後圖像的絕對路徑
    """

📚 詳細文檔

MCP 配置

添加到 mcp.json：

{
    "mcpServers": {
        "gemini-image-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/",
                "run",
                "server.py"
            ]
        }
    }
}

⚠️ 重要提示

⚠️ 重要提示

1. 確保配置中的路徑替換為絕對路徑。
2. API 密鑰必須通過環境變量設置。
3. 建議先運行示例代碼進行初步使用。
4. 生成的圖像默認保存在 generated-images 目錄。