Skip to main content
Glama
deenesjakoruzh

GPT Image 1 MCP

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

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

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

📄 Лицензия

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

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

How are these scores calculated?

hybrid server

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

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
              3
              4
              TypeScript

            • Image Toolkit MCP Server

              Kira-Pgr
              -
              security
              A
              license
              -
              quality
              A server that provides AI-powered image generation, modification, and processing capabilities through the Model Context Protocol, leveraging Google Gemini models and other image services.
              Last updated -
              12
              Python
              MIT License
              • Linux
              • Apple

            • OpenAI MCP

              jezweb
              -
              security
              A
              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 -
              2
              1
              JavaScript
              MIT License

            • OpenAI Image Generation MCP Server

              IncomeStreamSurfer
              -
              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 -
              16
              Python
              Apache 2.0
              • Linux
              • Apple

            View all related MCP servers

            New 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/CLOUDWERX-DEV/gpt-image-1-mcp'

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