Openai Image Generator

🚀 OpenAI GPT Image MCP

このツールサーバーは、OpenAIのGPT - 4o/gpt - image - 1画像生成と編集APIに対応したModel Context Protocol (MCP) を提供します。以下のような機能を持っています。

• テキストプロンプトを使用して画像を生成します。
• 高度なプロンプト制御により、画像の編集（inpainting、outpainting、compositingを含む）を行います。
• Claude Desktop、Cursor、VSCode、Windsurf、およびMCP互換のクライアントをサポートしています。

🚀 クイックスタート

このセクションでは、OpenAI GPT Image MCPの基本的な使い方を説明します。

✨ 主な機能

• create - image: 高級オプション（サイズ、品質、背景など）を使用して、プロンプトから画像を生成します。
• edit - image: プロンプトとオプションのマスクを使用して、画像を編集または拡張します。ファイルパスとbase64入力をサポートしています。
• ファイル出力: 生成された画像を直接ディスクに保存するか、base64として受け取ることができます。

📦 インストール

以下のコマンドを使用して、リポジトリをクローンし、依存関係をインストールします。

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の場合、nを設定することで、一度に最大10枚の画像を生成できます。
• edit - imageの場合、マスク画像（ファイルパスまたはbase64）を提供することで、編集を適用する位置を制御できます。
• すべてのオプションについては、src/index.tsを参照してください。

🧑‍💻 開発

• TypeScriptソースコード: src/index.ts
• ビルド: yarn build
• 実行: node dist/index.js

⚠️ 制限事項と大きなファイルの処理

• 1MBペイロード制限: MCPクライアント（Claude Desktopを含む）は、ツールの応答に1MBの厳格な上限があります。大きな画像（特に高解像度または複数の画像）は、base64で返されるとすぐにこの制限を超える可能性があります。
• 自動的なファイル出力への切り替え: 画像の総サイズが1MBを超える場合、ツールは自動的に画像をディスクに保存し、ファイルパスを返します。これにより、互換性が確保され、結果が最大長1048576を超えましたなどのエラーが防止されます。
• デフォルトのファイル保存場所: file_outputパスを指定しない場合、画像は/tmp（またはMCP_HF_WORK_DIR環境変数で設定されたディレクトリ）に一意のファイル名で保存されます。
• 環境変数:
  • MCP_HF_WORK_DIR: この変数を設定することで、大きな画像とファイル出力の保存場所を制御できます。例: export MCP_HF_WORK_DIR=/your/desired/dir
• ベストプラクティス: 大きな画像や本番環境での使用には、常にファイル出力を使用し、クライアントがファイルパスを処理できるように設定してください。

📚 ドキュメント

• OpenAIドキュメント

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。

💡 使用例

基本的な使用法

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

高度な使用法

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

🩺 トラブルシューティング

• 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）
• ファイル出力の場合、ディレクトリに書き込み権限があることを確認してください。
• ファイルタイプに関連するエラーが表示された場合は、画像ファイルの拡張子と形式を確認してください。

💡 使用提案

何か問題やフィードバックがある場合は、SureScale.aiまでご連絡ください。