gpt-image-2-polza-mcp-server

GPT Image 2 Polza MCP 服务

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

通过 API 提供商 Polza 使用 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	第二张参考图像
input_image_path_3	第三张参考图像
output_path	结果文件或文件夹的具体路径
force_new_generation	强制启动新的生成任务，而不使用缓存

超时后恢复

MCP 客户端超时后，Polza 端的生成任务可能仍在继续。不要立即重新运行相同的请求，否则可能会创建并支付另一项生成任务。

在 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。