openai-images-mcp
Connects to the OpenAI Images API (gpt-image-2) to generate and edit images. Provides tools for text-to-image generation (square/landscape/portrait, low/medium/high quality, up to 4 variants, transparent background), image editing by stored id or https URL, uploading source photos (including HEIC) via a generated link, drawing masks for localized edits, composing 2–6 images into a single result (clothing swaps, tattoos, objects, collages, style transfer), listing and deleting generated images, and tracking OpenAI spending per month and total.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Картинки OpenAI → Claude и ChatGPT
English: personal MCP connector for OpenAI image generation and editing (gpt-image-2) in Claude and ChatGPT, self-hosted on Cloudflare Workers free tier. Setup guide is in Russian.
Личный MCP-коннектор: генерируйте и редактируйте картинки моделью OpenAI gpt-image-2 прямо из чата Claude или ChatGPT — с телефона, в браузере, на компьютере.
«Нарисуй обложку для поста про осень, акварель» · «Замени фон на моём фото на море» · «Надень на человека с первого фото куртку со второго» · «Сделай стикер с прозрачным фоном»
Коннектор — ваш личный сервер на бесплатном тарифе Cloudflare Workers. Картинки оплачиваются напрямую с вашего баланса OpenAI по их тарифу, без наценок и подписок: обычная картинка в среднем качестве — около $0.04.
🤖 Хотите, чтобы всё сделал ИИ? Промт для Claude Code или Codex: docs/AGENT_PROMPT.md.
🧭 Не программист? Не страшно. Пошаговая инструкция для новичков (каждый клик, все ошибки и решения): docs/SETUP.md. 📄 PDF для печати и Telegram: docs/Инструкция-Картинки-OpenAI.pdf. Версия для форумного поста (BB-код): docs/4pda.bbcode.txt.
Что умеет
Инструмент | Что делает |
| Картинка по описанию: квадрат, альбомная или портретная; качество low / medium / high; до 4 вариантов; прозрачный фон |
| Доработка картинки — по id из хранилища или по прямой https-ссылке; исходник не меняется |
| Ссылка, по которой вы загружаете своё фото (любой формат, включая HEIC с айфона) |
| Рисовалка маски: меняется только закрашенная зона |
| Совместить 2–6 картинок по описанию: одежда, тату, предметы, коллаж, перенос стиля |
| Последние генерации и загрузки со ссылками |
| Удалить картинку (ссылка перестаёт работать) |
| Сколько потрачено на OpenAI через коннектор — за месяц и всего |
Готовые PNG хранятся 30 дней и открываются по неугадываемым ссылкам — их можно скачать, отправить в мессенджер или опубликовать в канал.
Related MCP server: Brand Images → Notion
Как это устроено
Claude / ChatGPT ──MCP──► ваш Worker на Cloudflare (этот репозиторий) ──► OpenAI Images API
│
└─ KV: токены, картинки 30 дней, загрузки, счётчик расходовВоркер — MCP-сервер (Streamable HTTP) и OAuth-сервер для ИИ-клиента (
@cloudflare/workers-oauth-provider).API-ключ OpenAI вы вводите один раз на странице подключения коннектора; он хранится в вашем OAuth-гранте в зашифрованном KV и в чат не попадает. Ключ проверяется бесплатным запросом.
Своё фото в чат «передать» нельзя: MCP-инструменты принимают только текст. Поэтому фото загружается отдельной ссылкой (
get_upload_link), страница пересжимает его сама.
Установка (кратко)
Полная инструкция — docs/SETUP.md.
OpenAI — аккаунт на platform.openai.com, пополненный баланс, верификация организации (обязательна для моделей gpt-image) и API-ключ.
Cloudflare — кнопка «Deploy to Cloudflare» выше: Cloudflare склонирует репозиторий в ваш GitHub, создаст KV и настроит автодеплой. Секретов задавать не нужно.
Подключение:
Claude: Settings → Connectors → Add custom connector →
https://<адрес-воркера>/mcp→ Connect → вставить ключ OpenAI;ChatGPT (Plus/Pro): Settings → Apps & Connectors → Advanced → Developer mode → Create → тот же URL, авторизация OAuth.
Установка с помощью ИИ-агента (Claude Code / Codex)
Откройте Claude Code или OpenAI Codex и вставьте промт из docs/AGENT_PROMPT.md. Агент сам выполнит терминальную часть, а браузерные шаги — OpenAI и подключение — проведёт с вами по одному клику. Ключ OpenAI вы вводите сами на странице коннектора, в чат он не попадает.
Ручная установка (без кнопки)
git clone https://github.com/deslabpro-max/openai-images-mcp.git
cd openai-images-mcp
npm install
npx wrangler login
npx wrangler kv namespace create OAUTH_KV # id → в wrangler.jsonc
npx wrangler deployСколько стоит
Cloudflare — бесплатно. OpenAI — по факту, точная сумма каждого вызова
возвращается в ответе и копится в get_spending.
Качество | Генерация, ≈ за картинку | Для чего |
low | $0.01–0.02 | черновики, поиск идеи |
medium | $0.04–0.06 | основная работа, посты |
high | $0.17–0.25 | финальные картинки |
Правка фото дороже генерации: входная картинка тоже оплачивается (medium — обычно $0.06–0.15).
Безопасность и приватность
Сервер ваш личный; код открыт (MIT).
Ключ OpenAI хранится в зашифрованном OAuth-гранте в вашем Cloudflare KV, в коде и в чатах его нет. Отозвать доступ — удалить ключ на platform.openai.com или отключить коннектор.
Картинки доступны по случайной ссылке без входа: всякий, у кого есть ссылка, сможет её открыть. Не генерируйте то, что не готовы показать, — или удаляйте через
delete_image.Если кто-то узнает адрес вашего воркера, он сможет подключиться только со своим ключом OpenAI — ваш баланс он не тратит.
Ограничения
Модели gpt-image требуют верификации организации в OpenAI; без неё генерация вернёт ошибку доступа.
OpenAI работает не во всех странах: нужен аккаунт и способ оплаты, которые OpenAI принимает.
Генерация в качестве high может идти дольше минуты, и чат прервёт ожидание по таймауту — но картинка всё равно сохранится: попросите «покажи последние картинки» (
list_images).Бесплатный KV Cloudflare: 1000 записей в сутки на аккаунт — хватает на сотни картинок в день.
Лицензия
MIT. Проект не аффилирован с OpenAI, Anthropic и Cloudflare.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models. Up to 4 images per call, SVG vectorization, background removal, upscaling and image-to-video. Remote MCP with OAuth, no API keys.
Make and edit images inside Claude chats. Ask in a sentence, edit by pointing. 10 free credits.
Generate images and video from Claude with one API key.
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models and 10 tools: up to 4 images per call, SVG vectorization, editing and more. Remote MCP with OAuth, no API keys. Pay per image, no subscription.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables generating images from text prompts using OpenAI's GPT-Image-2 model within Claude Code and Codex conversations.1MIT
- AlicenseNot gradedqualityDmaintenanceEnriches Claude with tools to generate brand-consistent images using OpenAI's gpt-image-2 and upload them directly to Notion pages.MIT
- FlicenseNot gradedqualityCmaintenanceA Cloudflare Worker exposing Google's Gemini 2.5 Flash Image model as an MCP tool for Claude.ai, enabling image generation and editing via natural language.-
- AlicenseAqualityDmaintenanceEnables Claude to generate and edit images using OpenAI's GPT Image models, with automatic model selection and local file saving.31MIT