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: imagegen-mcp

🚀 Установка

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

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

📚 Ссылки

• Документация API изображений OpenAI

🙏 Кредиты

• Создано с помощью @modelcontextprotocol/sdk

• Использует OpenAI Node.js SDK

• Создано SureScale.ai