Openai Image Generation

🚀 OpenAI画像生成MCPサーバー

このプロジェクトは、MCP（モデルコンテキストプロトコル）サーバーを実装しています。このサーバーは、OpenAIのgpt-image-1モデルを使用して、公式Python SDKを通じて画像の生成と編集を行うツールを提供します。

✨ 主な機能

このMCPサーバーは以下のツールを提供します。

• generate_image：テキストプロンプトに基づいて、OpenAIのgpt-image-1モデルを使用して画像を生成し、保存します。

  • 入力モード：

    {
      "type": "object",
      "properties": {
        "prompt": { "type": "string", "description": "必要な画像のテキスト説明。" },
        "model": { "type": "string", "default": "gpt-image-1", "description": "使用するモデル（現在は'gpt-image-1'）。" },
        "n": { "type": ["integer", "null"], "description": "生成する画像の数。", "minimum": 1 },
        "size": { "type": "string", "enum": ["512x512", "1024x1024"] },
        "response_format": { "type": "string", "enum": ["url", "b64_json"], "default": "url" }
      },
      "required": ["prompt"]
    }
    

  • 出力：{"status": "success", "output": "生成された画像のパスまたはURL"} またはエラー辞書。

• edit_image：プロンプトと入力画像に基づいて、OpenAIのgpt-image-1モデルを使用して画像を編集し、結果を保存します。

  • 入力モード：

    {
      "type": "object",
      "properties": {
        "prompt": { "type": "string", "description": "画像を編集するためのプロンプト。" },
        "image_path": { "type": "string", "description": "編集する画像のパス。" },
        "response_format": { "type": "string", "enum": ["url", "b64_json"], "default": "url" }
      },
      "required": ["prompt", "image_path"]
    }
    

  • 出力：{"status": "success", "output": "編集後の画像のパスまたはURL"} またはエラー辞書。

📦 インストール

前提条件

• Python（バージョン3.8以上を推奨）
• pip（Pythonパッケージインストーラー）
• OpenAI APIキー（スクリプト内で直接設定するか、OPENAI_API_KEY環境変数を使用して設定 - 環境変数を使用することはセキュリティ上重要です）。
• MCPサーバーを管理および起動できるMCPクライアント環境（例：Clineが使用する環境）。

インストール手順

1. リポジトリをクローンする：

   git clone https://github.com/IncomeStreamSurfer/chatgpt-native-image-gen-mcp.git
   cd chatgpt-native-image-gen-mcp
   

2. 仮想環境を設定する（推奨）：

   python -m venv venv
   source venv/bin/activate  # Windowsでは`venv\Scripts\activate`を使用
   

3. 依存関係をインストールする：

   pip install -r requirements.txt
   

4. （オプションだが推奨）環境変数を設定する： APIキーをスクリプトにハードコードするのではなく、OPENAI_API_KEY環境変数を設定します。この環境変数の設定方法は、使用するオペレーティングシステムによって異なります。

📚 ドキュメント

Cline MCPクライアント用の設定

AIアシスタント（例：Cline）からこのサーバーを使用できるようにするには、MCP設定ファイル（例：cline_mcp_settings.json）にその設定を追加します。

設定ファイルのmcpServersオブジェクトの下に以下のエントリを追加します。

{
  "mcpServers": {
    // ... 他のサーバー設定 ...

    "openai-image-gen-mcp": {
      "autoApprove": [
        "generate_image",
        "edit_image"
      ],
      "disabled": false,
      "timeout": 180, // 画像生成に時間がかかる可能性があるため、タイムアウト時間を増やす
      "command": "python", // またはPATHにない場合はPython実行ファイルのパス
      "args": [
        // 重要：このパスを、クローンしたリポジトリの実際の絶対パスに置き換える
        // あなたのマシン上の`openai_image_mcp.py`ファイルの場所
        "C:/path/to/your/cloned/repo/chatgpt-native-image-gen-mcp/openai_image_mcp.py"
      ],
      "env": {
        // 環境変数を使用してAPIキーを設定する場合：
        // "OPENAI_API_KEY": "YOUR_API_KEY_HERE"
      },
      "transportType": "stdio"
    }

    // ... 他のサーバー設定 ...
  }
}

注意：C:/path/to/your/cloned/repo/を、クローンしたリポジトリの実際の絶対パスに置き換えてください。パス区切り文字は、使用するオペレーティングシステムに適したものを使用してください（例：Windowsではバックスラッシュ\）。環境変数を使用してAPIキーを設定した場合は、スクリプトからAPIキーを削除し、MCPクライアントがサポートしている場合はenvセクションに追加することができます。

🚀 クイックスタート

通常、サーバーを手動で起動する必要はありません。MCPクライアント（例：Cline）は、最初のツールが呼び出されたときに、設定ファイルのcommandとargsを使用してサーバーを自動的に起動します。