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

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 или другой

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

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

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:

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

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

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

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

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

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

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

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.