Gemini Image MCP Server

🚀 Gemini 画像 MCP サーバー

Google Geminiをベースにした画像生成と編集サービスで、MCPプロトコルを通じてAI画像処理機能を提供します。

🚀 クイックスタート

Gemini 画像 MCP サーバーは、Google Geminiに基づいた画像生成と編集サービスです。MCPプロトコルを通じて、AIによる画像処理機能を提供します。

✨ 主な機能

• テキストからの画像生成 (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"

💻 使用例

基本的な使用法

generate_image

@mcp.tool()
async def generate_image(prompt: str, save_path: str = None) -> str:
    """
    :param prompt: 画像生成のプロンプト（英語での入力が望ましい）
    :param save_path: 保存先のパス（オプション、デフォルト：generated-images/ ディレクトリ）
    :return: 生成された画像の絶対パス
    """

edit_image

@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"
            ]
        }
    }
}

🔧 技術詳細

• このサービスはGoogle Geminiをベースにしており、MCPプロトコルを通じて画像生成と編集機能を提供します。
• APIキーは環境変数を通じて設定する必要があります。
• 生成された画像はデフォルトでgenerated-imagesディレクトリに保存されます。

📄 ライセンス

原READMEにライセンス情報が記載されていないため、このセクションは省略されています。

⚠️ 重要提示

1. 設定内のパスは絶対パスに置き換えてください。
2. APIキーは環境変数を通じて設定する必要があります。
3. 最初にサンプルコードを実行して、基本的な使い方を確認することをおすすめします。
4. 生成された画像はデフォルトでgenerated-imagesディレクトリに保存されます。