OpenAI 画像生成 MCP サーバー

このプロジェクトは、公式 Python SDK を介して OpenAI のgpt-image-1モデルを使用して画像を生成および編集するためのツールを提供する MCP (Model Context Protocol) サーバーを実装します。

特徴

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

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

  • 入力スキーマ:

    { "type": "object", "properties": { "prompt": { "type": "string", "description": "The text description of the desired image(s)." }, "model": { "type": "string", "default": "gpt-image-1", "description": "The model to use (currently 'gpt-image-1')." }, "n": { "type": ["integer", "null"], "default": 1, "description": "The number of images to generate (Default: 1)." }, "size": { "type": ["string", "null"], "enum": ["1024x1024", "1536x1024", "1024x1536", "auto"], "default": "auto", "description": "Image dimensions ('1024x1024', '1536x1024', '1024x1536', 'auto'). Default: 'auto'." }, "quality": { "type": ["string", "null"], "enum": ["low", "medium", "high", "auto"], "default": "auto", "description": "Rendering quality ('low', 'medium', 'high', 'auto'). Default: 'auto'." }, "user": { "type": ["string", "null"], "default": null, "description": "An optional unique identifier representing your end-user." }, "save_filename": { "type": ["string", "null"], "default": null, "description": "Optional filename (without extension). If None, a default name based on the prompt and timestamp is used." } }, "required": ["prompt"] }

  • 出力: {"status": "success", "saved_path": "path/to/image.png"}またはエラー辞書。

• edit_image : OpenAIのgpt-image-1モデルを使用して画像を編集またはバリエーションを作成し、保存します。複数の入力画像を参照として使用したり、マスクを使用してインペインティングを実行したりできます。

  • 入力スキーマ:

    { "type": "object", "properties": { "prompt": { "type": "string", "description": "The text description of the desired final image or edit." }, "image_paths": { "type": "array", "items": { "type": "string" }, "description": "A list of file paths to the input image(s). Must be PNG. < 25MB." }, "mask_path": { "type": ["string", "null"], "default": null, "description": "Optional file path to the mask image (PNG with alpha channel) for inpainting. Must be same size as input image(s). < 25MB." }, "model": { "type": "string", "default": "gpt-image-1", "description": "The model to use (currently 'gpt-image-1')." }, "n": { "type": ["integer", "null"], "default": 1, "description": "The number of images to generate (Default: 1)." }, "size": { "type": ["string", "null"], "enum": ["1024x1024", "1536x1024", "1024x1536", "auto"], "default": "auto", "description": "Image dimensions ('1024x1024', '1536x1024', '1024x1536', 'auto'). Default: 'auto'." }, "quality": { "type": ["string", "null"], "enum": ["low", "medium", "high", "auto"], "default": "auto", "description": "Rendering quality ('low', 'medium', 'high', 'auto'). Default: 'auto'." }, "user": { "type": ["string", "null"], "default": null, "description": "An optional unique identifier representing your end-user." }, "save_filename": { "type": ["string", "null"], "default": null, "description": "Optional filename (without extension). If None, a default name based on the prompt and timestamp is used." } }, "required": ["prompt", "image_paths"] }

  • 出力: {"status": "success", "saved_path": "path/to/image.png"}またはエラー辞書。

前提条件

• 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 # On Windows use `venv\Scripts\activate`

3. 依存関係をインストールします:

   pip install -r requirements.txt

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

構成（Cline MCP クライアント用）

このサーバーを AI アシスタント (Cline など) で使用できるようにするには、その構成を MCP 設定ファイル (例: cline_mcp_settings.json ) に追加します。

設定ファイルでmcpServersオブジェクトを見つけて、次のエントリを追加します。

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

サーバーの実行

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

手動でテストする場合（依存関係がインストールされ、API キーが使用可能であることを確認してください）：

使用法

AIアシスタントは、 generate_imageツールとedit_imageツールを使用してサーバーとやり取りします。画像は、 openai_image_mcp.pyスクリプトが配置されている場所に作成されたai-imagesサブディレクトリに保存されます。ツールは成功すると、保存された画像への絶対パスを返します。