GPT Image 2 プラグイン for Claude Desktop Code

OpenAI GPT Image 2 を使用してプロジェクトイメージを生成・編集するためのプラグインです。バンドルされたローカル MCP サーバーを通じて動作します。このプラグインは、有料呼び出しごとに1つの検証済み画像を生成し、承認されたプロジェクトワークスペース内にファイルを保持し、既存の保存先を上書きすることはありません。

简体中文

対応するClaudeの表面

このプラグインは、Claude Desktop アプリケーションのプロジェクト指向のコード体験である Claude Desktop Code 向けです。Claude Desktop Chat はサポートされていません。 これは MCPB パッケージではなく、リモート MCP サービスでもありません。

Related MCP server: mcp-openai-images-audio

Claude Desktop Code GUI からのインストール

GUI プラグインインストールが主要な方法です：

1. Claude Desktop Code で対象プロジェクトを開きます。

2. GUI の 設定 → プラグイン エリアを開きます。ラベルは Claude のリリースによって多少異なる場合があります。

3. このリポジトリのルートをローカルマーケットプレイスとして追加するか、そのリポジトリソースを選択し、gpt-image-2@kpk-plugins をインストールします。

4. 現在のプロジェクトに対してインストールしたプラグインを有効にします。有効化はプロジェクト固有です。インストールしても自動的にすべてのプロジェクトにアクセス権が付与されるわけではありません。

5. 設定のためにプラグイン設定を開きます。.mcp.json を通常の設定にコピーしないでください。

プラグインルートはマーケットプレイスルートであり、マーケットプレイスのエントリポイントは ./ を指します。

ランタイム要件

唯一のランタイム依存関係は Node.js 20+ で、Claude Desktop Code が見る PATH 上にある必要があります。インストールされたプラグインは、プリビルドされた dist/server.mjs を直接起動します。ランタイムでは、プラグインは npm、npx、ライフサイクルスクリプト、ソースコンパイル、node_modules のロードを実行しません。

コミットされたマーケットプレイスコピーにはスタンドアロンバンドルが含まれています。インストール済みコピーテストでは、Git 追跡ファイルのみが起動され、node_modules ディレクトリが存在しない状態、かつ API キーなしで get_status が動作することを確認します。

npm と開発依存関係は、ソースチェックアウトをビルドまたはテストするコントリビューターのみが必要です。

GUI での設定

プラグイン設定で、機密性の高い OpenAI API key フィールドに API キーを入力してください。コマンドライン、.env、.mcp.json、通常の設定、README、プロンプト、ログに入れたり、Claude に表示や検査を依頼したりしないでください。

デフォルトの公式ベース URL は次のとおりです：

https://api.openai.com/v1

カスタムベース URL には、このプラグインが送信する API キー、プロンプト、編集画像が送信されます。信頼するエンドポイントとそのオペレーターの場合にのみ設定してください。カスタムエンドポイントは通常 /v1 を含むべきです。プラグインは自動的に追加しません。ユーザー向けドキュメントの唯一の例は次のとおりです：

https://api.example.invalid/v1

URL は、資格情報、クエリ、フラグメント、制御文字、前後の空白を含まない絶対 HTTP(S) URL でなければなりません。互換性のあるエンドポイントは、OpenAI クライアントが使用する画像 API を実装している必要があります。互換性は URL を受け入れるだけで暗黙に示されるわけではありません。

HTTP は信頼できるローカルまたはプライベートネットワークの互換エンドポイントに対して許可されますが、API キー、プロンプト、編集画像がトランスポート暗号化なしで送信されます。http:// ベース URL は、信頼するネットワークとエンドポイントでのみ使用し、それ以外の場合は HTTPS を推奨します。

インストール後、/gpt-image-2:setup を実行してください。このコマンドは get_status のみを呼び出し、プロバイダーリクエストは行いません。

ツール

get_status

安全なステータスデータのみを報告します：API キーが設定されているかどうかのブール値、カスタムベース URL が設定されているかどうか、実行中のサーバーのアクティブ URL に対する base_url_valid: true、承認されたワークスペースルート、モデル、サーバーバージョン、デフォルトの相対出力ディレクトリ。無効な設定ベース URL はサーバーの起動を妨げます。プラグイン設定で修正し、プラグインをリロードまたは再起動してください。get_status はプロバイダーまたは画像 API リクエストを一切行わず、キーやベース URL の値を決して返しません。

generate_image

モデル gpt-image-2、固定 n: 1 で1つの画像を生成し、1つの新しいファイルを保存します。主な入力は次のとおりです：

• prompt

• quality：auto、low、medium、high

• size

• output_format：png、jpeg、webp

• オプションの JPEG/WebP の output_compression（0 から 100）

• moderation：auto または low

• オプションの相対 output_path と承認された workspace_root

edit_image

指定された順序で1つから8つの編集入力を編集し、1つの新しい画像を保存します。入力は PNG、JPEG、WebP のいずれかです。入力ごとの制限は 50 MiB、すべての編集画像とオプションのマスクを合わせた合計は 200 MiB です。

オプションのマスクは、アルファチャンネルを持つ PNG で、最初の入力画像と同じ寸法であり、4 MiB 未満でなければなりません。透明な出力背景はサポートされていません。マスクのアルファは編集領域を識別するためだけに使用されます。

フォーマット、サイズ、出力

• 出力フォーマット：PNG、JPEG、WebP。

• ツールのデフォルトサイズは 1024x1024 です。auto も受け入れられます。

• カスタムの WIDTHxHEIGHT は16の倍数を使用し、各辺は最大3840ピクセル、アスペクト比は1:3から3:1の間、総ピクセル数は655,360から8,294,400の間でなければなりません。

• PNG は出力圧縮を使用しません。JPEG と WebP は0から100の圧縮値を受け入れます。

• output_path が省略された場合、出力は .claude/generated-images/gpt-image-2 の下に、プロンプトを含まない一意のファイル名で保存されます。

• 明示的な出力パスは保持され、承認されたワークスペースルートからの相対パスでなければならず、要求されたフォーマットに一致する拡張子を使用する必要があります。

• 既存の保存先は拒否されます。上書き防止の公開により、同時呼び出しが同じターゲットを置き換えることも防ぎます。

実際の寸法は保持され、保存された画像がデコードおよび検証された後に報告されます。明示的に要求されたサイズが異なる場合、ファイルは実際の寸法で保存されたままとなり、結果には SIZE_MISMATCH が含まれます。

2 MiB 以下の画像にはインラインプレビューが含まれます。より大きな画像の場合、インラインプレビューは省略されます。保存されたファイルパスが引き続き信頼できます。TEMP_CLEANUP_PENDING は、出力が正常に保存されたが、一時的な公開ファイルのクリーンアップがまだ保留中であることを意味します。

コスト、同時実行、リトライ

生成と編集は有料のプロバイダー操作です。プラグインはリクエストごとに1つの出力を固定し、各サーバープロセスで一度に1つの有料呼び出しを許可します。SDK リトライもアプリケーションリトライもないため、失敗した有料呼び出しは自動的に再試行されません。画像ツールを呼び出す前に、プロンプト、編集入力、サイズ、フォーマット、出力パスを確認してください。

ワークスペースとセキュリティ境界

• 出力は、Claude Desktop Code によって承認されたワークスペースルート内に留まります。出力パスは絶対パスにすることはできず、ルートの外に移動することもできません。

• 含まれている絶対入力パスは、すでに承認されたルート内に解決される場合にのみ受け入れられます。入力パスが新しいルートを許可することはありません。

• 入力ファイルは、安定したハンドルを通じてプライベートな一時スナップショットにコピーされてからアップロードされます。元のファイルは変更されません。

• プロバイダー出力は厳密にデコードされ、画像が検証され、フラッシュされ、上書き防止のセマンティクスで公開されます。

• ログは、制限されたステータスコードと数値コンテキストのみを受け入れます。プロンプト、API キー、ベース URL、画像データ、Base64、完全な入力パスは除外されます。

Windows Node 20 ジャンクション境界

Windows 上で Node 20 を使用する場合、既存の再解析ポイント/ジャンクションエスケープは拒否され、出力親パスは排他的公開の直前に再チェックされます。チェック間で同じ権限の別のプロセスによるアクティブなディレクトリ置換は、脅威境界の外側にあります。その同じ権限の置換競合を完全に排除するには、ネイティブ Win32 ハンドル相対ヘルパーが必要です。

トラブルシューティング

• API キーが設定されていません： Claude Desktop Code プラグイン設定を開き、機密性の高い API キーフィールドに入力してください。キーをチャットやシェルに貼り付けないでください。

• 無効または未使用のカスタムベース URL： 無効な設定ベース URL はサーバーの起動を妨げます。プラグイン設定で修正し、設定が保存されたことを確認してから、プラグインをリロードまたは再起動してください。カスタムエンドポイントは通常 /v1 で終わるべきです。/v1 セグメントは自動的に追加されません。

• 承認されたワークスペースルートがありません： Claude Desktop Code でプロジェクトを開き、そのプロジェクトに対してプラグインを有効にしてください。

• OUTPUT_EXISTS： 新しい相対出力パスを選択してください。プラグインは上書きしません。

• SIZE_MISMATCH： 返された実際の幅と高さを使用してください。保存された画像は有効です。

• プレビューが省略されました： 返された相対パスまたは絶対パスを開いてください。インラインプレビューは 2 MiB に制限されています。

ソースからのビルドとテスト

開発コマンドは開発依存関係をインストールして使用する場合があります。これらはインストール済みプラグインのランタイム動作の一部ではありません。検証コマンドは、暗黙の npm ライフサイクルフックを無効にしてから、承認されたスクリプトセットが正確であることを確認します。

npm ci --ignore-scripts
npm run typecheck
npm test
npm run build
npm run test:dist
npm --ignore-scripts run validate

これらのチェックは、ローカルフィクスチャ、フェイク、プロトコルテストを使用します。有料の画像リクエストは必要ありません。ライブプロバイダーの検証は実行も主張もされていません。

ライセンス

MIT © 2026 KPK。 LICENSE および THIRD_PARTY_NOTICES.md を参照してください。