Skip to main content
Glama
deenesjakoruzh

GPT Image 1 MCP

by CLOUDWERX-DEV
OverviewInspectSchemaRelated ServersScoreDiscussions
JavaScript
Hybrid
MIT License
37
17

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

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

Related MCP server: Image Toolkit MCP Server

🔌 Интеграция с клиентами 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 с помощниками на основе ИИ:

    • ИИ всегда будет сообщать полное сообщение об ошибке, чтобы помочь в устранении неполадок.

    • ИИ объяснит вероятную причину ошибки простым языком

    • ИИ предложит конкретные шаги для решения проблемы

📄 Лицензия

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

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

How are these scores calculated?

Resources

Tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

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