openai-gpt-image-mcp
OpenAI の GPT-4o/gpt-image-1 画像生成および編集 API 用のモデル コンテキスト プロトコル (MCP) ツール サーバー。
OpenAI の最新モデルを使用して、テキスト プロンプトから画像を生成します。
高度なプロンプト コントロールを使用して画像を編集します(インペインティング、アウトペインティング、合成)。
サポート対象: Claude Desktop、Cursor、VSCode、Windsurf、および MCP 互換クライアント。
✨ 特徴
create-image : プロンプトから、詳細オプション (サイズ、品質、背景など) を使用して画像を生成します。
edit-image : プロンプトとオプションのマスクを使用して画像を編集または拡張します。ファイル パスと base64 入力の両方をサポートします。
ファイル出力: 生成された画像を直接ディスクに保存するか、base64 として受け取ります。
🚀 インストール
🔑 構成
Claude Desktop または VSCode (Cursor/Windsurf を含む) の設定に追加します。
⚡ 上級
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分かかる場合があります。
ファイル パスは絶対パスである必要があります。
ファイル出力の場合、ディレクトリが書き込み可能であることを確認してください。
ファイルの種類に関するエラーが表示される場合は、画像ファイルの拡張子と形式を確認してください。
⚠️ 制限事項と大きなファイルの処理
1MBのペイロード制限: MCPクライアント(Claude Desktopを含む)では、ツールレスポンスに1MBの厳格な制限があります。大きな画像(特に高解像度画像や複数の画像)をbase64で返すと、この制限を簡単に超えてしまう可能性があります。
**ファイル出力への自動切り替え:**画像サイズの合計が1MBを超える場合、ツールは自動的に画像をディスクに保存し、base64ではなくファイルパスを返します。これにより互換性が確保され、
result exceeds maximum length of 1048576といったエラーを回避できます。デフォルトのファイルの場所:
file_outputパスを指定しない場合、画像は一意のファイル名で/tmp(またはMCP_HF_WORK_DIR環境変数で設定されたディレクトリ) に保存されます。環境変数:
MCP_HF_WORK_DIR: 大きな画像やファイル出力の保存場所を制御するには、これを設定します。例:export MCP_HF_WORK_DIR=/your/desired/dir
**ベスト プラクティス:**大きな画像や実稼働画像の場合は、常にファイル出力を使用し、クライアントがファイル パスを処理できるように構成されていることを確認します。
📚 参考文献
🙏 クレジット
openai Node.js SDK を使用
SureScale.aiによって構築
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
OpenAI の画像モデルを通じて画像の生成と編集を可能にし、さまざまな MCP 互換クライアント間でのテキストから画像への生成と高度な画像編集 (インペインティング、アウトペインティング) をサポートする MCP ツール サーバー。
Related MCP Servers
- -security-license-qualityAn OpenAI API-based MCP server that provides deep thinking and analysis capabilities, integrating with AI editor models to deliver comprehensive insights and practical solutions.Last updated -
- -security-license-qualityAn MCP (Model Context Protocol) server that allows generating, editing, and creating variations of images using OpenAI's DALL-E APIs.
- -security-license-qualityProvides tools for generating and editing images using OpenAI's gpt-image-1 model via an MCP interface, enabling AI assistants to create and modify images based on text prompts.Last updated -16Apache 2.0
Recraft AI MCP Serverofficial
Asecurity-licenseAqualityAn MCP server that integrates with Recraft AI to enable generation and manipulation of high-quality raster and vector images through tools like image generation, editing, vectorization, background removal, and upscaling.Last updated -94335MIT License