Codex Images

codex-images-mcp

すでに利用料金を支払っているChatGPTプランで、gpt-image-2を使ってあらゆるMCPクライアントから画像を生成・編集できます。OpenAI APIキーは不要で、画像ごとの請求もありません。

codex-images-mcpは、Codex Imagesエンドポイント用のMCPサーバーです。ローカルでstdio経由、またはセルフホスト可能なHTTPサーバーとして実行でき、ノートパソコン、VPS上のエージェント、Pi／Gentle Shellのセッションから共有できます。生成されるすべての画像には、検証可能なアーティファクト情報が付属します。SHA-256、バイト数、MIMEタイプ、実際の寸法を確認できます。

非公式です。 OpenAIとは提携しておらず、承認も受けていません。ご自身のChatGPTアカウントでサインインし、Codex CLIと同じエンドポイントを使用します。ご利用のアカウントに適用されるOpenAIの規約に従う必要があり、画像生成はプランの利用上限に含まれます。

利用できる機能

• 2つのツール：codex_images（生成／編集）とcodex_images_artifact（URI、インライン、または短時間有効な署名付きダウンロードで画像を取得）。
• バッチ処理：parallel、variants、chain、branded-parallel（ブランドに一貫性のあるセットを作成できるよう、各画像が共通の基準画像を参照します）。
• 参照画像とマスクを使った編集：1リクエストにつき最大5枚の参照画像に対応。HTTPS URLまたはインライン画像を指定できます。
• ネイティブの透明度：モデルから実際のアルファ付きPNGを取得し、結果が不透明だった場合は警告します。
• 正確な出力サイズ：native、exact、fit、coverによる後処理に対応。1200×630のカードを1200×630で出力できます。
• プロンプトをそのまま送信：間に隠れた書き換えモデルを挟みません。
• 任意のAPIキーエンジン：OPENAI_API_KEYを設定してCODEX_IMAGES_ENGINE=apiを指定すると、モデル（Images 2.6のgpt-image-2.6-sunburst／-flare）を自分で選択でき、品質をmaxまで指定できるほか、複雑さも調整できます。このエンジンの料金はAPIアカウントに請求されます。デフォルトのChatGPTプラン経由ではOpenAIがモデルを選択し、APIの指定項目（model、quality、complexity）は無視されます。
• デフォルトで安全なセルフホスティング：組み込みのベアラー認証を備え、トークンなしでパブリックにリッスンすることを拒否します。SSRF対策を施したURL取得（HTTPS、パブリックアドレスのみ、IP固定、リダイレクトなし）に対応し、結果にサーバー上のパスを含めません。
• 専用のChatGPTセッション：codex-images-mcp loginはデバイスコードを使って別のセッションを維持するため、Codexアプリのサインインがローテーションされる（そして壊れる）ことはありません。

クイックスタート（ローカル、stdio）

uvx --from codex-images-mcp codex-images-mcp login     # sign in once (device code)
uvx --from codex-images-mcp codex-images-mcp setup     # register in Claude Code, Claude Desktop, Codex, Cursor, OpenCode

または、ターミナルからお試しください。

uvx --from codex-images-mcp codex-images-mcp generate "a ceramic mug, studio light" --transparent --pretty

Codex CLIにすでにサインインしていますか？codex-images-mcpは、トークンの有効期限が切れるまで、そのログイン情報を読み取り専用で使用できます。トークンの更新は行いません。専用のセッションを使うにはloginを実行してください。

出力例

このサーバーを介してgpt-image-2で生成した出力例です。このページでは画像を縮小して表示しています。透明背景の画像生成と、参照画像とマスクを送信して編集する例はdocs/examples.mdで紹介しています。

左側の生成では、プロンプトにa ceramic mug, studio lightを指定し、transparentを設定しました。モデルから返されたのは1536×1024のPNGで、サイズは1,745,462バイト、sha256はe0d0338218529ca36e0d64e92eb2737c6794b392343f1a5ab32884a49dab48baです。編集では、このマグカップを参照画像として送り、正面にマスクをかけて、小さな濃い茶色のコーヒー豆の刻印を追加するよう依頼しました。返されたのは1536×1024のPNGで、sha256は7c5b28d4950f5207c111f875ef9d19349e06be3da43ce1200d2d8d2c678b9ba5です。カメラの角度はわずかに変化しました。マスクは目安であり、モデルがフレーム全体を調整する場合があります。

生成結果は、実際のアルファチャンネルを持つPNGです。背景の市松模様は表示用の背景にすぎず、透明な背景を見えるようにしています。

このフォルダーには、オフホワイトの生成画像、市松模様の背景に合成した編集画像、および1200pxの透明PNGである生成画像と編集画像もあります。

セルフホスト（HTTP）

export CODEX_IMAGES_HTTP_TOKEN=$(openssl rand -hex 32)
docker compose up -d
docker compose run --rm codex-images codex-images-mcp login

クライアントの接続先を https://your-host/mcp/ に設定し、Authorization: Bearer $CODEX_IMAGES_HTTP_TOKEN を指定してください。リバースプロキシ、署名付きダウンロード、各種設定については、docs/self-hosting.md をご覧ください。

Pi と Gentle Shell

pi-codex-images は、セルフホスト型サーバー用の Pi 拡張機能です。許可されたローカルファイルを読み込み、インラインで送信し、検証済みの結果をプロジェクトにアトミックに書き込みます。

pi install npm:pi-codex-images

ドキュメント

• MCP ツールのリファレンス：入力、結果、エラーコード。
• CLI：generate、login、logout、setup、status、uninstall。
• セルフホスト：Docker、リバースプロキシ、設定、セキュリティモデル。
• 使用例：バッチ処理、編集、マスク、透明度、正確なサイズ。
• 比較：類似プロジェクトとの違い。

クレジット

codex-images-mcp は、wauwa による VelmoAI/codex-imagen のフォークとして始まりました。インストーラーと元の構成の多くは、そこから引き継いでいます。OAuth トークン処理は、Small Turtle 2 による codex-image-gen を基にしています。生成エンジンはネイティブの Codex Images エンドポイントに置き換えられ、プロンプト書き換えとクロマキーのレイヤーは削除されました。

ライセンス

MIT。LICENSE と NOTICE をご覧ください。