Skip to main content
Glama
Sign In
deenesjakoruzh

GPT Image 1 MCP

by CLOUDWERX-DEV
npmGitHub
JavaScript
MIT License
323
1
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Uses curl commands for proper MIME handling when working with image files, especially for the image editing functionality.

  • Runs as a Node.js application, with the MCP server requiring Node.js v14+ to function properly.

  • Available as an npm package that can be installed globally or run directly with npx, making it easy to integrate with various MCP clients.

🚀 Быстрый старт

npx -y @cloudwerxlab/gpt-image-1-mcp

📋 Предварительные условия

🔑 Переменные среды

💻 Пример использования с NPX

# Set your OpenAI API key export OPENAI_API_KEY=sk-your-openai-api-key # Optional: Set custom output directory export GPT_IMAGE_OUTPUT_DIR=/home/username/Pictures/ai-generated-images # Run the server with NPX npx -y @cloudwerxlab/gpt-image-1-mcp
# Set your OpenAI API key $env:OPENAI_API_KEY = "sk-your-openai-api-key" # Optional: Set custom output directory $env:GPT_IMAGE_OUTPUT_DIR = "C:\Users\username\Pictures\ai-generated-images" # Run the server with NPX npx -y @cloudwerxlab/gpt-image-1-mcp
:: Set your OpenAI API key set OPENAI_API_KEY=sk-your-openai-api-key :: Optional: Set custom output directory set GPT_IMAGE_OUTPUT_DIR=C:\Users\username\Pictures\ai-generated-images :: Run the server with NPX npx -y @cloudwerxlab/gpt-image-1-mcp

🔌 Интеграция с клиентами MCP

🛠️ Настройка в клиенте MCP

{ "mcpServers": { "gpt-image-1": { "command": "npx", "args": [ "-y", "@cloudwerxlab/gpt-image-1-mcp" ], "env": { "OPENAI_API_KEY": "PASTE YOUR OPEN-AI KEY HERE", "GPT_IMAGE_OUTPUT_DIR": "OPTIONAL: PATH TO SAVE GENERATED IMAGES" } } } }
Примеры конфигураций для разных операционных систем
{ "mcpServers": { "gpt-image-1": { "command": "npx", "args": ["-y", "@cloudwerxlab/gpt-image-1-mcp"], "env": { "OPENAI_API_KEY": "sk-your-openai-api-key", "GPT_IMAGE_OUTPUT_DIR": "C:\\Users\\username\\Pictures\\ai-generated-images" } } } }
{ "mcpServers": { "gpt-image-1": { "command": "npx", "args": ["-y", "@cloudwerxlab/gpt-image-1-mcp"], "env": { "OPENAI_API_KEY": "sk-your-openai-api-key", "GPT_IMAGE_OUTPUT_DIR": "/home/username/Pictures/ai-generated-images" } } } }

Примечание : Для путей Windows используйте двойные обратные косые черты ( \\ ), чтобы экранировать символ обратной косой черты в JSON. Для Linux/macOS используйте прямые косые черты ( / ).

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

💡 Расширенные возможности

🔄 Как это работает

📁 Поведение выходного каталога

Установка и использование

Пакет НПМ

Этот пакет доступен на npm: @cloudwerxlab/gpt-image-1-mcp

Вы можете установить его глобально:

npm install -g @cloudwerxlab/gpt-image-1-mcp

Или запустите его напрямую с помощью npx, как показано в разделе «Быстрый старт».

Инструмент: create_image

Создает новое изображение на основе текстовой подсказки.

Параметры
ПараметрТипНеобходимыйОписание
promptнитьДаТекстовое описание изображения, которое необходимо сгенерировать (макс. 32 000 символов)
sizeнитьНетРазмер изображения: «1024x1024» (по умолчанию), «1536x1024» или «1024x1536»
qualityнитьНетКачество изображения: «высокое» (по умолчанию), «среднее» или «низкое»
nцелое числоНетКоличество изображений для генерации (1-10, по умолчанию: 1)
backgroundнитьНетСтиль фона: «прозрачный», «непрозрачный» или «авто» (по умолчанию)
output_formatнитьНетФормат вывода: «png» (по умолчанию), «jpeg» или «webp»
output_compressionцелое числоНетУровень сжатия (0-100, по умолчанию: 0)
userнитьНетИдентификатор пользователя для отслеживания использования OpenAI
moderationнитьНетУровень модерации: «низкий» или «авто» (по умолчанию)
Пример
<use_mcp_tool> <server_name>gpt-image-1</server_name> <tool_name>create_image</tool_name> <arguments> { "prompt": "A futuristic city skyline at sunset, digital art", "size": "1024x1024", "quality": "high", "n": 1, "background": "auto" } </arguments> </use_mcp_tool>
Ответ

Инструмент возвращает:

  • Отформатированное текстовое сообщение с подробностями о созданном изображении(ях)
  • Изображение(я) в виде данных, закодированных в base64
  • Метаданные, включая использование токенов и пути к файлам

Инструмент: create_image_edit

Редактирует существующее изображение на основе текстовой подсказки и дополнительной маски.

Параметры
ПараметрТипНеобходимыйОписание
imageстрока, объект или массивДаИзображение(я) для редактирования (строка base64 или объект пути к файлу)
promptнитьДаТекстовое описание желаемой правки (макс. 32 000 символов)
maskстрока или объектНетМаска, определяющая области для редактирования (строка base64 или объект пути к файлу)
sizeнитьНетРазмер изображения: «1024x1024» (по умолчанию), «1536x1024» или «1024x1536»
qualityнитьНетКачество изображения: «высокое» (по умолчанию), «среднее» или «низкое»
nцелое числоНетКоличество изображений для генерации (1-10, по умолчанию: 1)
backgroundнитьНетСтиль фона: «прозрачный», «непрозрачный» или «авто» (по умолчанию)
userнитьНетИдентификатор пользователя для отслеживания использования OpenAI
Пример с изображением, закодированным в Base64
<use_mcp_tool> <server_name>gpt-image-1</server_name> <tool_name>create_image_edit</tool_name> <arguments> { "image": "BASE64_ENCODED_IMAGE_STRING", "prompt": "Add a small robot in the corner", "mask": "BASE64_ENCODED_MASK_STRING", "quality": "high" } </arguments> </use_mcp_tool>
Пример с путем к файлу
<use_mcp_tool> <server_name>gpt-image-1</server_name> <tool_name>create_image_edit</tool_name> <arguments> { "image": { "filePath": "C:/path/to/your/image.png" }, "prompt": "Add a small robot in the corner", "mask": { "filePath": "C:/path/to/your/mask.png" }, "quality": "high" } </arguments> </use_mcp_tool>
Ответ

Инструмент возвращает:

  • Отформатированное текстовое сообщение с подробностями об отредактированном изображении(ях)
  • Отредактированное изображение(я) в виде данных, закодированных в base64
  • Метаданные, включая использование токенов и пути к файлам

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

🚨 Распространенные проблемы

🔍 Обработка ошибок и отчетность

Сервер MCP включает в себя комплексную обработку ошибок, которая предоставляет подробную информацию, когда что-то идет не так. Когда возникает ошибка:

  1. Формат ошибки : Все ошибки возвращаются с:
    • Четкое сообщение об ошибке, описывающее, что пошло не так
    • Конкретный код или тип ошибки
    • Дополнительный контекст об ошибке, если он доступен
  2. Поведение помощника на основе ИИ : При использовании этого сервера MCP с помощниками на основе ИИ:
    • ИИ всегда будет сообщать полное сообщение об ошибке, чтобы помочь в устранении неполадок.
    • ИИ объяснит вероятную причину ошибки простым языком
    • ИИ предложит конкретные шаги для решения проблемы

📄 Лицензия

🙏 Благодарности

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

Сервер Model Context Protocol, позволяющий генерировать и редактировать изображения с использованием модели OpenAI gpt-image-1, что позволяет помощникам ИИ создавать и изменять изображения с помощью текстовых подсказок.

  1. 📋 Предварительные условия
    1. 🔑 Переменные среды
      1. 💻 Пример использования с NPX
        1. 🔌 Интеграция с клиентами MCP
          1. 🛠️ Настройка в клиенте MCP
        2. ✨ Особенности
          1. 💡 Расширенные возможности
        3. 🔄 Как это работает
          1. 📁 Поведение выходного каталога
        4. Установка и использование
          1. Пакет НПМ
          2. Инструмент: create_image
          3. Инструмент: create_image_edit
        5. 🔧 Устранение неполадок
          1. 🚨 Распространенные проблемы
          2. 🔍 Обработка ошибок и отчетность
        6. 📄 Лицензия
          1. 🙏 Благодарности

            Related Resources

            Related MCP Servers

            • Ideogram MCP Server

              Sunwood-ai-labs
              A
              security
              F
              license
              A
              quality
              A Model Context Protocol server that provides image generation capabilities using the Ideogram API, allowing users to create images from text prompts with customizable parameters.
              Last updated -
              1
              1
              3
              JavaScript

            • OpenAI MCP

              jezweb
              -
              security
              -
              license
              -
              quality
              A Model Context Protocol server enabling AI assistants to generate images through OpenAI's DALL-E API with full support for all available options and fine-grained control.
              Last updated -
              JavaScript
              MIT License

            • MCPollinations Multimodal MCP Server

              pinkpixel-dev
              A
              security
              A
              license
              A
              quality
              A Model Context Protocol server that enables AI assistants to generate images, text, and audio through the Pollinations APIs without requiring authentication.
              Last updated -
              7
              325
              4
              JavaScript
              MIT License
              • Linux
              • Apple

            • OpenAI GPT Image MCP

              SureScaleAI
              -
              security
              A
              license
              -
              quality
              An MCP tool server that enables generating and editing images through OpenAI's image models, supporting text-to-image generation and advanced image editing (inpainting, outpainting) across various MCP-compatible clients.
              Last updated -
              11
              TypeScript
              MIT License

            View all related MCP servers

            New MCP Servers

            ID: msnns8io3m