Openai Image Generation

該項目實現了一個MCP服務器，通過OpenAI的gpt-image-1模型提供圖像生成和編輯功能，支持文本描述生成圖像、基於參考圖像編輯或修復圖像，並可將結果保存到本地。

.Python

評分 : 2.5分

下載量 : 27

更新時間 : 2025-05-07

什麼是OpenAI Image Generation MCP Server?

這是一個基於Model Context Protocol (MCP)的服務器，允許您通過簡單的命令生成和編輯圖像。它使用OpenAI的先進圖像生成模型來滿足您的創意需求。

如何使用OpenAI Image Generation MCP Server?

只需輸入簡單的命令，即可生成或編輯圖像。無需複雜的配置，您可以輕鬆開始使用。

適用場景

適用於需要高質量圖像生成或編輯的場景，例如插畫設計、廣告創作、概念藝術等。

主要功能

生成圖像根據提供的文本描述生成一張或多張圖像。

編輯圖像對現有圖像進行編輯或創建新版本，支持多種高級編輯選項。

優勢與侷限性

優勢

高質量圖像生成，支持多種尺寸和質量設置。

易於使用，無需複雜的技術知識。

強大的編輯功能，適合專業設計師和創意人員。

侷限性

需要穩定的網絡連接以訪問OpenAI API。

可能產生較高的API使用費用，具體取決於生成次數。

對於非常複雜的圖像任務，可能需要多次嘗試才能達到理想效果。

如何使用

安裝和配置

確保已安裝Python 3.8或更高版本，並通過pip安裝依賴。設置您的OpenAI API密鑰。

啟動服務器

使用MCP客戶端自動啟動服務器，或者手動運行腳本。

使用工具

調用生成或編輯工具，輸入所需參數。

使用案例

生成風景圖像根據描述生成一張美麗的山景圖像。

編輯現有圖像更新現有圖像的背景。

常見問題

如何設置API密鑰？

生成圖像需要多長時間？

如何查看生成的圖像？

🚀 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使用的環境）。

安裝步驟

克隆倉庫：

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

設置虛擬環境（推薦）：

python -m venv venv
source venv/bin/activate  # 在Windows上使用`venv\Scripts\activate`

安裝依賴項：

pip install -r requirements.txt

（可選但推薦）設置環境變量：設置OPENAI_API_KEY環境變量，而非將API密鑰硬編碼在腳本中。根據您的操作系統，設置此環境變量的方式有所不同。

📚 詳細文檔

配置（用於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", // 或Python可執行文件的路徑，如果不在PATH中
      "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"
    }

    // ... 其他服務器配置 ...
  }
}