Gpt Image 2 Polza Mcp Server

io.github.ivanantigravity-lgtmPublished by GitHub account ivanantigravity-lgtmv0.6.2Updated Oct 24, 2026

GPT Image 2 MCP server backed by Polza media and storage APIs.

VerifiedSTDIODesktop onlyMedia & DesignAI & ML

Overview

AI-generated overview

A local MCP server that lets an assistant generate and edit images with the GPT Image 2 model through the Polza media and storage APIs.

What you can do
Generate or edit images from a text prompt, with resolution, aspect ratio and up to three reference images, saving full-size files to disk and returning previews and metadata through MCP. Fetch the result of an already started generation by its gen_ ID. Upload reference files to Polza Storage. Show statistics for the local output folder. Maintain the local cache and metadata database.
When to use it
Useful when you want an assistant to create or edit images on demand, such as ad frames or product shots, and keep the resulting files locally. Also suited to recovering a generation that outlived the client timeout instead of re-running it.
Requirements
Runs locally as a Python package (Python 3.11+ and uv). Needs a Polza account and the POLZA_AI_API_KEY environment variable; optional settings include POLZA_BASE_URL, IMAGE_OUTPUT_DIR, GPT_IMAGE_MODEL, polling intervals, POLZA_EXTERNAL_USER_ID and RETURN_FULL_IMAGE. Network access to the Polza API is required.
Before you install
Requires the POLZA_AI_API_KEY secret, which is passed in the client configuration. Generations are billed by Polza, and re-running a request after a timeout can create and pay for a second generation. The server uploads reference files to Polza Storage and can delete stored files. It writes images and cache data to local disk.

Installation

In SourceWeft

  1. Open Gpt Image 2 Polza Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

GPT Image 2 Polza MCP Server

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

MCP-сервер для генерации и редактирования изображений моделью GPT Image 2 через API-провайдера Polza.

  • Провайдер: 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 или другой

Быстрая установка

Клонируйте репозиторий:

bash
git clone https://github.com/ivanantigravity-lgtm/gpt-image-2-polza-mcp.gitcd gpt-image-2-polza-mcpuv sync

Создайте .mcp.json:

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-клиент после добавления конфигурации.

Использование

Обычная генерация:

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

Основные параметры generate_image:

ПараметрОписание
promptТекстовое описание изображения или инструкция по редактированию
modegenerate, edit или автоматическое определение
model_tiergpt-image-2; используется по умолчанию
resolution1k, 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Принудительно запустить новую генерацию вместо использования кэша

Восстановление после таймаута

Генерация может продолжаться на стороне Polza после таймаута MCP-клиента. Не запускайте тот же запрос повторно сразу: это может создать и оплатить ещё одну генерацию.

Получите gen_... ID в истории генераций Polza и вызовите:

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

Переменные окружения

ПеременнаяОбязательноОписание
POLZA_AI_API_KEYДаAPI-ключ аккаунта Polza
POLZA_BASE_URLНетБазовый URL API; по умолчанию 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НетВнешний ID пользователя для Polza
RETURN_FULL_IMAGEНетВозвращать полное изображение вместо превью

Локальный запуск

bash
cp .env.example .envuv syncuv run gpt-image-2-polza-mcp-server

Минимальный .env:

env
POLZA_AI_API_KEY=your-polza-api-keyPOLZA_BASE_URL=https://polza.ai/apiGPT_IMAGE_MODEL=gpt-image-2IMAGE_OUTPUT_DIR=/absolute/path/to/gpt-image-2-output

API Polza

Сервер использует:

  • POST /v1/media — запуск генерации
  • GET /v1/media/{id} — получение статуса и результата
  • POST /v1/storage/upload — загрузка референсов
  • GET /v1/storage/files/{id} — метаданные файла
  • DELETE /v1/storage/files/{id} — удаление файла

Лицензия

MIT. См. LICENSE.

Source: README.md at commit 7cf559f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.6.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts