{
  "markdown": "# GPT Image 2 Polza MCP Server\n\n`mcp-name: io.github.ivanantigravity-lgtm/gpt-image-2-polza-mcp-server`\n\nMCP-сервер для генерации и редактирования изображений моделью **GPT Image 2**\nчерез API-провайдера [Polza](https://polza.ai).\n\n- Провайдер: `Polza`\n- Model ID: `openai/gpt-5.4-image-2`\n- Model tier: `gpt-image-2`\n- Поддержка генерации, редактирования и референсных изображений\n- Сохранение полноразмерных файлов на диск\n- Возврат превью и структурированных метаданных через MCP\n\nДля работы нужен только `POLZA_AI_API_KEY`. Отдельный ключ OpenAI не требуется.\n\n## Инструменты MCP\n\n- `generate_image` — создаёт или редактирует изображения с помощью GPT Image 2.\n- `fetch_generation` — получает результат уже запущенной генерации по `gen_...` ID.\n- `upload_file` — загружает референс в Polza Storage.\n- `show_output_stats` — показывает статистику локальной папки с результатами.\n- `maintenance` — обслуживает локальный кэш и базу метаданных.\n\n## Требования\n\n- Python 3.11+\n- [uv](https://docs.astral.sh/uv/)\n- Аккаунт Polza и `POLZA_AI_API_KEY`\n- Любой MCP-клиент: Claude Code, Claude Desktop, Cursor, VS Code или другой\n\n## Быстрая установка\n\nКлонируйте репозиторий:\n\n```bash\ngit clone https://github.com/ivanantigravity-lgtm/gpt-image-2-polza-mcp.git\ncd gpt-image-2-polza-mcp\nuv sync\n```\n\nСоздайте `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"gpt-image-2-polza\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"run\",\n        \"gpt-image-2-polza-mcp-server\"\n      ],\n      \"cwd\": \"/absolute/path/to/gpt-image-2-polza-mcp\",\n      \"env\": {\n        \"POLZA_AI_API_KEY\": \"your-polza-api-key\",\n        \"POLZA_BASE_URL\": \"https://polza.ai/api\",\n        \"IMAGE_OUTPUT_DIR\": \"/absolute/path/to/gpt-image-2-output\"\n      }\n    }\n  }\n}\n```\n\nПерезапустите MCP-клиент после добавления конфигурации.\n\n## Использование\n\nОбычная генерация:\n\n```text\nСоздай рекламный кадр флакона духов на чёрном камне,\nкинематографический свет, формат 16:9, разрешение 4K.\nИспользуй gpt-image-2.\n```\n\nОсновные параметры `generate_image`:\n\n| Параметр | Описание |\n|---|---|\n| `prompt` | Текстовое описание изображения или инструкция по редактированию |\n| `mode` | `generate`, `edit` или автоматическое определение |\n| `model_tier` | `gpt-image-2`; используется по умолчанию |\n| `resolution` | `1k`, `2k`, `4k` или `high` |\n| `aspect_ratio` | Например, `1:1`, `16:9`, `9:16`, `4:5` |\n| `input_image_path_1` | Путь к основному референсу или редактируемому изображению |\n| `input_image_path_2` | Второй референс |\n| `input_image_path_3` | Третий референс |\n| `output_path` | Конкретный файл или папка для результата |\n| `force_new_generation` | Принудительно запустить новую генерацию вместо использования кэша |\n\n## Восстановление после таймаута\n\nГенерация может продолжаться на стороне Polza после таймаута MCP-клиента. Не\nзапускайте тот же запрос повторно сразу: это может создать и оплатить ещё одну\nгенерацию.\n\nПолучите `gen_...` ID в истории генераций Polza и вызовите:\n\n```text\nfetch_generation(\n  media_id=\"gen_2158267363095220225\",\n  output_path=\"/absolute/path/to/result.png\"\n)\n```\n\n## Переменные окружения\n\n| Переменная | Обязательно | Описание |\n|---|---|---|\n| `POLZA_AI_API_KEY` | Да | API-ключ аккаунта Polza |\n| `POLZA_BASE_URL` | Нет | Базовый URL API; по умолчанию `https://polza.ai/api` |\n| `IMAGE_OUTPUT_DIR` | Нет | Папка результатов; по умолчанию `~/gpt-image-2-images` |\n| `GPT_IMAGE_MODEL` | Нет | Model tier; по умолчанию `gpt-image-2` |\n| `POLZA_POLL_INTERVAL_SECONDS` | Нет | Интервал проверки статуса генерации |\n| `POLZA_POLL_TIMEOUT_SECONDS` | Нет | Максимальное время ожидания результата |\n| `POLZA_EXTERNAL_USER_ID` | Нет | Внешний ID пользователя для Polza |\n| `RETURN_FULL_IMAGE` | Нет | Возвращать полное изображение вместо превью |\n\n## Локальный запуск\n\n```bash\ncp .env.example .env\nuv sync\nuv run gpt-image-2-polza-mcp-server\n```\n\nМинимальный `.env`:\n\n```env\nPOLZA_AI_API_KEY=your-polza-api-key\nPOLZA_BASE_URL=https://polza.ai/api\nGPT_IMAGE_MODEL=gpt-image-2\nIMAGE_OUTPUT_DIR=/absolute/path/to/gpt-image-2-output\n```\n\n## API Polza\n\nСервер использует:\n\n- `POST /v1/media` — запуск генерации\n- `GET /v1/media/{id}` — получение статуса и результата\n- `POST /v1/storage/upload` — загрузка референсов\n- `GET /v1/storage/files/{id}` — метаданные файла\n- `DELETE /v1/storage/files/{id}` — удаление файла\n\n## Лицензия\n\nMIT. См. [LICENSE](LICENSE).\n",
  "bytes": 4346,
  "sha": "fc9cfcac3aa43ee3d2ae2af192fab8351d67912efaa308142a80284739348ccc",
  "repo_slug": "ivanantigravity-lgtm/gpt-image-2-polza-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ivanantigravity_lgtm_gpt_image_7db545ee/readme"
}