Openai Image Generator

🚀 openai-gpt-image-mcp

一個用於OpenAI的GPT-4o/gpt-image-1圖像生成和編輯API的Model Context Protocol (MCP)工具服務器。它可以使用文本提示生成圖像，還能通過高級提示控制實現對圖像的編輯，並且支持Claude Desktop、Cursor、VSCode、Windsurf等與MCP兼容的客戶端。

🚀 快速開始

安裝

git clone https://github.com/SureScaleAI/openai-gpt-image-mcp.git
cd openai-gpt-image-mcp
yarn install
yarn build

配置

添加到Claude Desktop或VSCode（包括Cursor/Windsurf）配置中：

{
  "mcpServers": {
    "openai-gpt-image-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": { "OPENAI_API_KEY": "sk-..." }
    }
  }
}

✨ 主要特性

• create-image：使用高級選項（大小、質量、背景等）從提示生成圖像。
• edit-image：使用提示和可選遮罩編輯或擴展圖像，支持文件路徑和base64輸入。
• 文件輸出：直接將生成的圖像保存到磁盤，或接收為base64。

🔧 技術細節

高級功能

• 對於create-image，設置n以一次生成多達10張圖像。
• 對於edit-image，提供一個遮罩圖像（文件路徑或base64）來控制編輯應用的位置。
• 查看src/index.ts獲取所有選項。

開發

• TypeScript源代碼：src/index.ts
• 構建：yarn build
• 運行：node dist/index.js

🩺 問題排查

• 確保您的OPENAI_API_KEY有效，並且具有圖像API訪問權限。
• 您必須擁有一個驗證的OpenAI組織。驗證後，圖像API訪問權限可能需要15–20分鐘才能激活。
• 文件路徑必須是絕對路徑。
  • Unix/macOS/Linux：以/開頭（例如/path/to/image.png）
  • Windows：驅動器號後跟:（例如C:/path/to/image.png或C:\path\to\image.png）
• 對於文件輸出，確保目錄可寫。
• 如果看到與文件類型相關的錯誤，請檢查圖像文件的擴展名和格式。

⚠️ 侷限性和大文件處理

• 1MB有效載荷限制：MCP客戶端（包括Claude Desktop）對工具響應有一個嚴格的1MB上限。大型圖像（尤其是高分辨率或多張圖像）很容易因返回base64而超出此限制。
• 自動切換到文件輸出：如果總圖像大小超過1MB，工具將自動將圖像保存到磁盤並返回文件路徑，而不是base64。這確保了兼容性並防止結果超過最大長度1048576之類的錯誤。
• 默認文件位置：如果您未指定file_output路徑，圖像將保存到 /tmp(或由MCP_HF_WORK_DIR環境變量設置的目錄)中的唯一文件名。
• 環境變量：
  • MCP_HF_WORK_DIR：設置此變量以控制大圖像和文件輸出的位置。示例：export MCP_HF_WORK_DIR=/your/desired/dir
• 最佳實踐：對於大型或生產用途的圖像，始終使用文件輸出，並確保客戶端配置為處理文件路徑。

📚 詳細文檔

OpenAI文檔

💡 使用建議

如果有任何問題或反饋，請聯繫SureScale.ai。

📄 許可證

MIT