Qhdrl12 MCP Server Gemini Image Generator

🚀 双子星画像生成器MCPサーバの使用

GoogleのGeminiモデルを使用し、MCPプロトコルを通じてテキストプロンプトから高品質な画像を生成します。

🚀 クイックスタート

このMCPサーバを使用すると、任意のAIアシスタントがGoogleのGemini AIモデルを利用して画像を生成できます。サーバは、プロンプトエンジニアリング、テキストから画像への変換、スマートなファイル名生成、およびローカル画像保存を処理し、任意のMCPクライアントを通じたAI生成画像の作成と管理を簡単にします。

✨ 主な機能

• テキストからの画像生成：テキスト記述から高品質な画像を生成します。
• 画像変換：プロンプトに基づいて既存の画像を編集および修正します。
• スマートなファイル名：生成された画像に関連する意味のあるファイル名を自動生成します。
• 多形式サポート：PNG、JPEGなどの複数の画像出力形式をサポートします。

📚 ドキュメント

使用するMCPツール

1. generate_image_from_text

テキスト記述に基づいて新しい画像を生成します。

戻り値

• image_data: Base64エンコードされた画像データ
• filename: 自動生成されたファイル名

2. transform_image

プロンプトに基づいて既存の画像を編集します。

戻り値

• modified_image_data: 処理後の画像データ
• transform_result: 処理結果を記述するJSONオブジェクト

3. apply_stylization

既存の画像にスタイルを適用します。

戻り値

• stylized_image_data: スタイルが適用された画像データ
• applied_style: 適用されたスタイルの情報を記録したログ

📦 インストール

インストール手順

1. リポジトリをクローンします。

   git clone https://github.com/your-username/gemini-image-generator.git
   cd gemini-image-generator
   

2. 仮想環境を作成し、依存関係をインストールします。

   # 通常のvenvを使用
   python -m venv .venv
   source .venv/bin/activate
   pip install -e .
   
   # またはuvを使用
   uv venv
   source .venv/bin/activate
   uv pip install -e .
   

3. サンプル環境ファイルをコピーし、APIキーを追加します。

   cp .env.example .env
   

4. .env ファイルを編集し、Gemini APIキーと出力先パスを入力します。

   GEMINI_API_KEY="your-gemini-api-key-here"
   OUTPUT_IMAGE_PATH="/path/to/save/images"
   

Claude Desktopの設定

claude_desktop_config.json に以下の内容を追加します（macOSの場合）。

{
    "mcpServers": {
        "gemini-image-generator": {
            "command": "uv",
            "args": [
                "--directory",
                "/absolute/path/to/gemini-image-generator",
                "run",
                "server.py"
            ],
            "env": {
                "GEMINI_API_KEY": "GEMINI_API_KEY",
                "OUTPUT_IMAGE_PATH": "OUTPUT_IMAGE_PATH"
            }
        }
    }
}

💻 使用例

インストールが完了したら、以下のコマンドでサービスを起動できます。

fastmcp dev server.py

これにより、ローカル開発サーバが起動し、http://localhost:5173/ でMCPチェック画面が提供され、ユーザーは直接画像生成ツールをテストできます。

📄 ライセンス

MIT License