MCP Server Gemini Image Generator

🚀 双子星画像生成器MCPサーバーを使用した高品質画像の作成

このプロジェクトでは、GoogleのGeminiモデルを利用し、MCPプロトコルを通じて、テキストプロンプトから高品質な画像を生成することができます。

🚀 クイックスタート

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

✨ 主な機能

• Gemini 2.0バージョンFlashを使用して、テキストプロンプトから画像を生成
• テキストプロンプトに基づいて既存の画像を変換
• ファイルベースとBase64エンコードの画像処理をサポート
• 重複を避けるために一意のハッシュファイル名を自動生成
• 生成および変換されたすべての画像を指定されたパスに保存

📦 インストール

インストール要件

• Python 3.8以上
• 仮想環境管理ツール（venvやuvなど）

必要な依存関係

server.pyを実行する前に、以下のPythonパッケージをインストールする必要があります。

fastapi==0.68.1
python-multipart==0.2.1
requests>=2.25.1
Pillow>=9.0.1

📚 ドキュメント

新しい画像の生成

テキストプロンプトを通じて全く新しい画像を作成します。様々なアートスタイルと画像サイズをサポートしています。

• 文字での説明を提供するだけで、クリエイティブな画像を生成
• 幅、高さ、品質などのパラメータを調整可能
• 一意のファイル名を自動生成し、指定された出力パスに保存

既存画像の変換

既存の画像に変換や編集を施します。

• 既存の画像に視覚的なエフェクトを適用
• 照明、色バランスなどの属性を変更
• 画像要素の追加または削除
• シーンの雰囲気やテーマを変更

💻 使用例

基本的な使用法

新しい画像の生成のリクエスト形式

GeminiImageGenerator.create_image(
    prompt: str,
    width: int = 512,
    height: int = 512,
    quality: int = 90,
    style: str = "realistic",
) -> dict:

画像変換のリクエスト形式

GeminiImageGenerator.transform_image(
    image_path_or_url: str, 
    prompt: str,
    width: Optional[int] = None,
    height: Optional[int] = None,
    quality: int = 90
) -> dict:

📚 ドキュメント

セットアップガイド

インストール手順

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

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

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

python -m venv .venv
source .venv/bin/activate
pip install -e .

3. サンプル環境ファイルをコピーし、パラメータを設定します。

cp .env.example .env

4. .envファイルを編集して、APIキーと出力パスを追加します。

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

Claude Desktopの設定

claude_desktop_config.jsonに以下の内容を追加します。

{
    "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"
            }
        }
    }
}

使用方法

インストールが完了したら、以下の方法で画像を生成または変換できます。

新しい画像の生成

• 詳細な文字説明を提供
• サイズと品質のパラメータを調整可能
• 自動生成し、指定されたパスに保存

既存画像の変換

• ローカルファイルをアップロードまたはWebのURLを提供
• プロンプトに基づいてスマートな編集を行う
• トリミング、回転、フィルターの適用をサポート

テストとデバッグ

FastMCP開発サーバーを使用してテストすることができます。

fastmcp dev server.py

起動後、http://localhost:5173/でMCP Inspector画面にアクセスし、Claudeや他のクライアントを使用せずに画像生成ツールを直接テストすることができます。

📄 ライセンス

MIT License