gpt-image-2-polza-mcp-server

GPT Image 2 Polza MCP Server

mcp-name: io.github.ivanantigravity-lgtm/gpt-image-2-polza-mcp-server

Polza API プロバイダーを通じて、GPT Image 2 モデルで画像を生成・編集する MCP サーバーです。

• プロバイダー：Polza
• Model ID：openai/gpt-5.4-image-2
• Model tier：gpt-image-2
• 生成、編集、参照画像に対応
• フルサイズのファイルをディスクに保存
• MCP を通じてプレビューと構造化メタデータを返します

必要なのは POLZA_AI_API_KEY のみです。OpenAI のキーは別途必要ありません。

MCP ツール

• generate_image — GPT Image 2 を使用して画像を作成または編集します。
• fetch_generation — gen_... ID を指定して、すでに開始された生成の結果を取得します。
• upload_file — Polza Storage に参照画像をアップロードします。
• show_output_stats — ローカルの出力フォルダーの統計情報を表示します。
• maintenance — ローカルのキャッシュとメタデータベースを保守します。

要件

• Python 3.11+
• uv
• Polza アカウントと POLZA_AI_API_KEY
• 任意の MCP クライアント：Claude Code、Claude Desktop、Cursor、VS Code など

クイックインストール

リポジトリをクローンします：

git clone https://github.com/ivanantigravity-lgtm/gpt-image-2-polza-mcp.git
cd gpt-image-2-polza-mcp
uv sync

.mcp.json を作成します：

{
  "mcpServers": {
    "gpt-image-2-polza": {
      "command": "uv",
      "args": [
        "run",
        "gpt-image-2-polza-mcp-server"
      ],
      "cwd": "/absolute/path/to/gpt-image-2-polza-mcp",
      "env": {
        "POLZA_AI_API_KEY": "your-polza-api-key",
        "POLZA_BASE_URL": "https://polza.ai/api",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/gpt-image-2-output"
      }
    }
  }
}

設定を追加した後、MCP クライアントを再起動してください。

使い方

通常の生成：

Создай рекламный кадр флакона духов на чёрном камне,
кинематографический свет, формат 16:9, разрешение 4K.
Используй gpt-image-2.

generate_image の主なパラメーター：

パラメーター	説明
prompt	画像のテキストによる説明、または編集の指示
mode	generate、edit、または自動判定
model_tier	gpt-image-2。デフォルトで使用されます
resolution	1k、2k、4k、または high
aspect_ratio	例：1:1、16:9、9:16、4:5
input_image_path_1	メインの参照画像または編集対象画像のパス
input_image_path_2	2 枚目の参照画像
input_image_path_3	3 枚目の参照画像
output_path	結果の保存先となるファイルまたはフォルダー
force_new_generation	キャッシュを使用せず、新しい生成を強制的に開始します

タイムアウト後の復旧

MCP クライアントがタイムアウトした後も、Polza 側で生成が続行される場合があります。同じリクエストをすぐに再実行しないでください。生成がもう 1 件作成され、課金される可能性があります。

Polza の生成履歴で gen_... ID を取得し、次を呼び出します：

fetch_generation(
  media_id="gen_2158267363095220225",
  output_path="/absolute/path/to/result.png"
)

環境変数

変数	必須	説明
POLZA_AI_API_KEY	はい	Polza アカウントの API キー
POLZA_BASE_URL	いいえ	API のベース URL。デフォルトは https://polza.ai/api
IMAGE_OUTPUT_DIR	いいえ	出力フォルダー。デフォルトは ~/gpt-image-2-images
GPT_IMAGE_MODEL	いいえ	Model tier。デフォルトは gpt-image-2
POLZA_POLL_INTERVAL_SECONDS	いいえ	生成ステータスを確認する間隔
POLZA_POLL_TIMEOUT_SECONDS	いいえ	結果を待つ最大時間
POLZA_EXTERNAL_USER_ID	いいえ	Polza 用の外部ユーザー ID
RETURN_FULL_IMAGE	いいえ	プレビューではなく、画像全体を返します

ローカルでの起動

cp .env.example .env
uv sync
uv run gpt-image-2-polza-mcp-server

最小限の .env：

POLZA_AI_API_KEY=your-polza-api-key
POLZA_BASE_URL=https://polza.ai/api
GPT_IMAGE_MODEL=gpt-image-2
IMAGE_OUTPUT_DIR=/absolute/path/to/gpt-image-2-output

Polza API

サーバーでは次を使用します：

• POST /v1/media — 生成を開始します
• GET /v1/media/{id} — ステータスと結果を取得します
• POST /v1/storage/upload — 参照画像をアップロードします
• GET /v1/storage/files/{id} — ファイルのメタデータを取得します
• DELETE /v1/storage/files/{id} — ファイルを削除します

ライセンス

MIT。詳細は LICENSE を参照してください。