Codex / OpenAI Image

codex-openai-image-mcp

Claude（およびほかのあらゆる MCP クライアント）から画像を生成、編集し、統一感のあるセットを作成し、結果を見てさらに作業を続けられる MCP サーバーです。

2 つの画像バックエンドに対応しています。

• Codex CLI：Codex CLI を通じて、すでにお持ちの ChatGPT プランを使用します。API キーは不要で、画像ごとの料金もかかりません。
• OpenAI Images API：Codex をお持ちでない方向けに、OPENAI_API_KEY を使用します。

OpenAI とは提携しておらず、OpenAI による推奨も受けていません。「OpenAI」と「Codex」は OpenAI の商標です。

画像を編集：「車と構図はそのままに、夜のシーンにして」

1 回の呼び出しで統一感のあるセットを作成：「かわいいフラットなステッカー：コーヒー、サボテン、月」

どちらの例も、Codex バックエンドによる実際の出力で、加工はしていません。

特長

• 統一感のあるセット。 generate_set は、共通のスタイルを持つ複数の異なる画像を生成し、それぞれ別の名前で保存します。
• 2 つのバックエンド、1 つのインターフェース。 1 つの設定で Codex と OpenAI API を切り替えられます。
• エージェントのループ向けに設計。 呼び出しのたびに、Claude が確認できる小さなプレビューを返します。長時間の実行中は進行状況を報告し、キャンセルにも対応します。また、各画像の隣にプロンプトと設定を記録した .json サイドカーファイルを作成します。
• ファイルを慎重に扱います。 出力フォルダー内にのみ書き込み、既存のファイルを上書きせず、編集対象の画像を変更しません。また、Codex は空の一時フォルダーで読み取り専用で実行します。

クイックスタート

Node.js 20.3 以降と、次のいずれかが必要です。

• Codex CLI。codex login でサインインし、Codex の画像生成が含まれる ChatGPT プランをお使いください。または
• クレジットのある OpenAI API キー。

Claude Code

# Codex backend (your ChatGPT plan)
claude mcp add images -e IMAGEGEN_PROVIDER=codex-cli -- npx -y codex-openai-image-mcp

# or the OpenAI API
claude mcp add images -e IMAGEGEN_PROVIDER=openai-api -e OPENAI_API_KEY=sk-... -- npx -y codex-openai-image-mcp

Claude Desktop、Cursor、その他のクライアント

クライアントの MCP 設定に追加します（Claude Desktop の場合は claude_desktop_config.json）。

{
  "mcpServers": {
    "images": {
      "command": "npx",
      "args": ["-y", "codex-openai-image-mcp"],
      "env": { "IMAGEGEN_PROVIDER": "codex-cli" }
    }
  }
}

API バックエンドを使用する場合は、"IMAGEGEN_PROVIDER": "openai-api" を指定し、"OPENAI_API_KEY" を追加します。

あとは次のように依頼するだけです。

• 「ブログのヘッダー用に、水彩画風のキツネを作って。1536x864 で。」
• 「photo.png を夕焼けのような見た目に編集して。」
• 「統一感のあるアプリアイコンを 5 個作って。ホーム、検索、プロフィール、設定、ベル。」

画像は、クライアントの起動元フォルダー内にある ./generated-images に保存されます。

ツール

generate_image

入力	デフォルト	説明
prompt	必須
size	1024x1024	1 辺が 16～4096 px の任意の WxH
count	1	1～4 個のバリエーションを生成し、-v1、-v2、…として保存
transparent	false	透明な背景を指定します。出力に透明部分がない場合は、その旨が結果に示されます
references	[]	スタイルを合わせる画像を最大 4 枚指定
out_name	プロンプトをスラッグ化したもの	出力フォルダー内の拡張子なしのパス。例：icons/rocket

edit_image

入力	デフォルト	説明
image	必須	変更する画像。元画像は変更されません
prompt	必須	変更内容。例：「左側の人物を削除して」、「水彩画風にして」
size	入力画像のサイズ	WxH
mask	なし	透明部分を編集範囲として示す PNG（OpenAI API のみ）
count	1	1～4 個のバリエーション
transparent	false	切り抜きなどに使用
references	[]	挿入する画像や適用するスタイルなど、参考画像を最大 3 枚指定
out_name	<input name>-edited

generate_set

入力	デフォルト	備考
style	必須	すべての画像に共通する要素：メディア、パレット、レンダリング、背景
items	必須	1～8 個の { name, prompt }。それぞれ <folder>/<name>.png として保存されます
size	1024x1024	すべての画像に共通
transparent	false
references	[]	セット全体のスタイルを合わせる参照画像（最大 4 枚）
folder	style のスラッグ	出力フォルダー内のフォルダー

すべてのツールは、結果を指定したサイズに正確にトリミングおよびリサイズし、保存したパスと 各画像の 512 px プレビューを返します。

バックエンド

	codex-cli	openai-api	mock
必要なもの	Codex CLI、サインイン済み	OPENAI_API_KEY	なし
費用	ChatGPT プランの利用枠	画像ごと	無料
速度	画像あたり約 30～60 秒	モデルとサイズによって異なります	即時
参照、編集、透過	はい	はい	編集のみ
編集マスク	いいえ	はい	いいえ
セット	セット全体で 1 つの Codex セッション	1 回に 1 画像。最初の画像をスタイル参照として使用	1 回に 1 画像

mock はプレースホルダー画像を描画します。サーバーを試したり、テストを実行したりする場合に使います。

Codex バックエンド。 各呼び出しでは、Codex に組み込みの image_gen ツールだけを呼び出すよう指示するプロンプトとともに、 codex exec --json --skip-git-repo-check --sandbox read-only --cd <empty temp folder> [--image=<file>…] -- - を実行します。サーバーは Codex の JSON イベントからセッション ID を読み取り、 $CODEX_HOME/generated_images/<session id>/ から画像を収集します。Codex に書き込みアクセス権はなく、渡した画像以外でプロジェクトを参照することもありません。リクエストをキャンセルするかタイムアウトになると、Codex は停止します。 プランで Codex CLI をスクリプトから使用する場合は、OpenAI の利用規約を確認してください。

OpenAI バックエンド。 公式の openai SDK を使用します。デフォルトのモデルは gpt-image-2.5-sunburst です。より速い結果を得るには、IMAGEGEN_OPENAI_MODEL=gpt-image-2.5-flare を設定してください。サイズは API が受け付けるサイズに丸められた後、指定したサイズにリサイズされます。このバックエンドは、モッククライアントを使った自動テストで検証されていますが、実環境での完全なテストはまだ実施されていません。

設定

変数	デフォルト
IMAGEGEN_PROVIDER	mock。codex-cli または openai-api を設定します
OPENAI_API_KEY	openai-api で必須
IMAGEGEN_OPENAI_MODEL	gpt-image-2.5-sunburst
IMAGEGEN_CODEX_BIN	codex
IMAGEGEN_OUT_DIR	generated-images。作業フォルダーからの相対パス
IMAGEGEN_READ_ROOT	作業フォルダー。入力画像はこのフォルダー内に置く必要があります
IMAGEGEN_TIMEOUT_SEC	300。要求した画像 1 枚あたり
IMAGEGEN_MAX_PER_CALL	画像 8 枚
IMAGEGEN_PREVIEW_SIZE	512 px

ファイルと安全性

• 出力は IMAGEGEN_OUT_DIR 内にのみ書き込まれます。絶対パス、..、および外部につながるシンボリックリンクは拒否されます。
• 入力画像（編集用または参照用）は IMAGEGEN_READ_ROOT 内に置く必要があります。
• 既存のファイルは上書きされません。新しいファイルには代わりに -2、-3、…が付加されます。
• 各画像には、プロンプト、バックエンド、モデル、サイズ、入力、時刻を記録した <name>.json サイドカーファイルが作成されます。
• API キーは環境変数からのみ読み込まれ、ログにもサイドカーファイルにも記録されません。
• IMAGEGEN_MAX_PER_CALL は、1 回の呼び出しで生成できる画像の数を制限します。

画像は AI によって生成されます。AI 生成コンテンツに関するプラットフォームのルールを守り、実在の人物やブランドを模倣しないことを含め、画像の使用にはご自身で責任を負ってください。

開発

git clone https://github.com/meet30997/codex-openai-image-mcp.git
cd codex-openai-image-mcp
npm install
npm run build
npm test          # unit and end-to-end tests; no network or API key needed
npm run inspect   # try the tools in the MCP Inspector

Claude Code からローカルビルドを実行するには：

claude mcp add images -e IMAGEGEN_PROVIDER=codex-cli -- node /path/to/codex-openai-image-mcp/dist/index.js

テストでは、スタンドインスクリプト（test/fixtures/fake-codex.mjs）を使って Codex バックエンドを、フェイククライアントを使って OpenAI バックエンドを実行するため、無料ですぐに完了します。PLAN.md に設計メモとロードマップがあります。Issue やプルリクエストを歓迎します。

ライセンス

MIT