openai-gpt-image-mcp

Сервер инструментов Model Context Protocol (MCP) для API-интерфейсов OpenAI для генерации и редактирования изображений GPT-4o/gpt-image-1.

Создавайте изображения из текстовых подсказок, используя новейшие модели OpenAI.
Редактируйте изображения (закрашивание, перекрашивание, композиция) с расширенными функциями оперативного управления.
Поддерживает : Claude Desktop, Cursor, VSCode, Windsurf и любой MCP-совместимый клиент.

✨ Особенности

create-image : создание изображений по запросу с расширенными параметрами (размер, качество, фон и т. д.).
edit-image : редактирование или расширение изображений с использованием подсказки и дополнительной маски, поддерживающей как пути к файлам, так и ввод base64.
Вывод файла : сохранение созданных изображений непосредственно на диск или получение в формате base64.

Related MCP server: DALL-E MCP Server

🚀 Установка

git clone https://github.com/SureScaleAI/openai-gpt-image-mcp.git cd openai-gpt-image-mcp yarn install yarn build

🔑 Конфигурация

Добавьте в конфигурацию Claude Desktop или VSCode (включая Cursor/Windsurf):

{ "mcpServers": { "openai-gpt-image-mcp": { "command": "node", "args": ["/absolute/path/to/dist/index.js"], "env": { "OPENAI_API_KEY": "sk-..." } } } }

⚡ Продвинутый

Для create-image установите n , чтобы сгенерировать до 10 изображений одновременно.
Для edit-image укажите изображение маски (путь к файлу или base64) для управления тем, где применяются изменения.
Все варианты смотрите src/index.ts .

🧑‍💻 Разработка

Исходный код TypeScript: src/index.ts
Сборка: yarn build
Запустить: node dist/index.js

📝 Лицензия

Массачусетский технологический институт

🩺 Устранение неполадок

Убедитесь, что ваш OPENAI_API_KEY действителен и имеет доступ к API изображений.
У вас должна быть проверенная организация OpenAI . После проверки может потребоваться 15–20 минут для активации доступа к API изображения.
Пути к файлам должны быть абсолютными.
- Unix/macOS/Linux : Начинается с / (например, /path/to/image.png )
- Windows : буква диска, за которой следует : (например, C:/path/to/image.png или C:\path\to\image.png )
Для вывода файла убедитесь, что каталог доступен для записи.
Если вы видите ошибки, связанные с типами файлов, проверьте расширения и форматы файлов изображений.

⚠️ Ограничения и обработка больших файлов

Ограничение полезной нагрузки в 1 МБ: клиенты MCP (включая Claude Desktop) имеют жесткое ограничение в 1 МБ для ответов инструмента. Большие изображения (особенно с высоким разрешением или множественные изображения) могут легко превысить этот лимит, если будут возвращены в виде base64.
Автоматическое переключение на вывод файла: если общий размер изображения превышает 1 МБ, инструмент автоматически сохранит изображения на диск и вернет путь(и) к файлу вместо base64. Это обеспечивает совместимость и предотвращает ошибки, такие как result exceeds maximum length of 1048576 .
Расположение файла по умолчанию: если не указать путь file_output , изображения будут сохранены в /tmp (или в каталоге, заданном переменной среды MCP_HF_WORK_DIR ) с уникальным именем файла.
Переменная среды:
- MCP_HF_WORK_DIR : Установите это, чтобы контролировать, где сохраняются большие изображения и выходные файлы. Пример: export MCP_HF_WORK_DIR=/your/desired/dir
Рекомендация: для больших или производственных изображений всегда используйте вывод в виде файла и убедитесь, что ваш клиент настроен на обработку путей к файлам.