OpenAI GPT Image MCP

by SureScaleAI
Integrations
  • Provides tools for generating and editing images using OpenAI's GPT-4o/gpt-image-1 APIs, supporting text-to-image generation, image editing operations (inpainting, outpainting, compositing), and advanced prompt control.

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.

🚀 Установка

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
  • Рекомендация: для больших или производственных изображений всегда используйте вывод в виде файла и убедитесь, что ваш клиент настроен на обработку путей к файлам.

📚 Ссылки


🙏 Кредиты

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Сервер инструментов MCP, позволяющий генерировать и редактировать изображения с помощью моделей изображений OpenAI, поддерживающий генерацию текста в изображение и расширенное редактирование изображений (закрашивание, закрашивание) на различных клиентах, совместимых с MCP.

  1. ✨ Особенности
    1. 🚀 Установка
      1. 🔑 Конфигурация
        1. ⚡ Продвинутый
          1. 🧑‍💻 Разработка
            1. 📝 Лицензия
              1. 🩺 Устранение неполадок
                1. ⚠️ Ограничения и обработка больших файлов
                  1. 📚 Ссылки
                    1. 🙏 Кредиты

                      Related MCP Servers

                      • A
                        security
                        A
                        license
                        A
                        quality
                        An MCP Server that integrates with Stability AI's API to provide high-quality image generation, editing, and manipulation capabilities including background removal, outpainting, search-and-replace, and upscaling.
                        Last updated -
                        13
                        35
                        55
                        TypeScript
                        MIT License
                        • Apple
                      • -
                        security
                        F
                        license
                        -
                        quality
                        An MCP server that allows users to generate, edit, and create variations of images through OpenAI's DALL-E API, supporting both DALL-E 2 and DALL-E 3 models.
                        Last updated -
                        2
                        TypeScript
                      • A
                        security
                        F
                        license
                        A
                        quality
                        An MCP (Model Context Protocol) server that allows generating, editing, and creating variations of images using OpenAI's DALL-E APIs.
                        Last updated -
                        1
                        TypeScript
                      • -
                        security
                        A
                        license
                        -
                        quality
                        Provides tools for generating and editing images using OpenAI's gpt-image-1 model via an MCP interface, enabling AI assistants to create and modify images based on text prompts.
                        Last updated -
                        10
                        Python
                        Apache 2.0
                        • Linux
                        • Apple

                      View all related MCP servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/SureScaleAI/openai-gpt-image-mcp'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server