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

🚀 Inicio rápido

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

📋 Requisitos previos

🔑 Variables de entorno

💻 Ejemplo de uso con 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

🔌 Integración con clientes MCP

🛠️ Configuración en un cliente 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" } } } }
Configuraciones de ejemplo para diferentes sistemas operativos
{ "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" } } } }

Nota : Para las rutas de Windows, use barras invertidas dobles ( \\ ) para escapar la barra invertida en JSON. Para Linux/MacOS, use barras diagonales ( / ).

✨ Características

💡 Capacidades mejoradas

🔄 Cómo funciona

📁 Comportamiento del directorio de salida

Instalación y uso

Paquete NPM

Este paquete está disponible en npm: @cloudwerxlab/gpt-image-1-mcp

Puedes instalarlo globalmente:

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

O ejecútelo directamente con npx como se muestra en la sección Inicio rápido.

Herramienta: create_image

Genera una nueva imagen basándose en una solicitud de texto.

Parámetros
ParámetroTipoRequeridoDescripción
promptcadenaSíLa descripción del texto de la imagen a generar (máximo 32.000 caracteres)
sizecadenaNoTamaño de la imagen: "1024x1024" (predeterminado), "1536x1024" o "1024x1536"
qualitycadenaNoCalidad de imagen: "alta" (predeterminada), "media" o "baja"
nenteroNoNúmero de imágenes a generar (1-10, predeterminado: 1)
backgroundcadenaNoEstilo de fondo: "transparente", "opaco" o "automático" (predeterminado)
output_formatcadenaNoFormato de salida: "png" (predeterminado), "jpeg" o "webp"
output_compressionenteroNoNivel de compresión (0-100, predeterminado: 0)
usercadenaNoIdentificador de usuario para el seguimiento del uso de OpenAI
moderationcadenaNoNivel de moderación: «bajo» o «automático» (predeterminado)
Ejemplo
<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>
Respuesta

La herramienta devuelve:

  • Un mensaje de texto formateado con detalles sobre las imágenes generadas
  • Las imágenes como datos codificados en base64
  • Metadatos que incluyen el uso de tokens y rutas de archivos

Herramienta: create_image_edit

Edita una imagen existente basándose en un mensaje de texto y una máscara opcional.

Parámetros
ParámetroTipoRequeridoDescripción
imagecadena, objeto o matrizSíLas imágenes a editar (cadena base64 u objeto de ruta de archivo)
promptcadenaSíLa descripción del texto de la edición deseada (máximo 32.000 caracteres)
maskcadena u objetoNoLa máscara que define las áreas a editar (cadena base64 u objeto de ruta de archivo)
sizecadenaNoTamaño de la imagen: "1024x1024" (predeterminado), "1536x1024" o "1024x1536"
qualitycadenaNoCalidad de imagen: "alta" (predeterminada), "media" o "baja"
nenteroNoNúmero de imágenes a generar (1-10, predeterminado: 1)
backgroundcadenaNoEstilo de fondo: "transparente", "opaco" o "automático" (predeterminado)
usercadenaNoIdentificador de usuario para el seguimiento del uso de OpenAI
Ejemplo con imagen codificada en 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>
Ejemplo con ruta de archivo
<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>
Respuesta

La herramienta devuelve:

  • Un mensaje de texto formateado con detalles sobre las imágenes editadas
  • Las imágenes editadas como datos codificados en base64
  • Metadatos que incluyen el uso de tokens y rutas de archivos

🔧 Solución de problemas

🚨 Problemas comunes

🔍 Manejo y generación de informes de errores

El servidor MCP incluye un sistema integral de gestión de errores que proporciona información detallada cuando algo falla. Cuando se produce un error:

  1. Formato de error : Todos los errores se devuelven con:
    • Un mensaje de error claro que describe qué salió mal
    • El código o tipo de error específico
    • Contexto adicional sobre el error cuando esté disponible
  2. Comportamiento del asistente de IA : al utilizar este servidor MCP con asistentes de IA:
    • La IA siempre informará el mensaje de error completo para ayudar con la solución de problemas.
    • La IA explicará la causa probable del error en un lenguaje sencillo.
    • La IA sugerirá pasos específicos para resolver el problema.

📄 Licencia

🙏 Agradecimientos

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

Un servidor de protocolo de contexto de modelo que permite generar y editar imágenes utilizando el modelo gpt-image-1 de OpenAI, lo que permite a los asistentes de IA crear y modificar imágenes a partir de indicaciones de texto.

  1. 📋 Requisitos previos
    1. 🔑 Variables de entorno
      1. 💻 Ejemplo de uso con NPX
        1. 🔌 Integración con clientes MCP
          1. 🛠️ Configuración en un cliente MCP
        2. ✨ Características
          1. 💡 Capacidades mejoradas
        3. 🔄 Cómo funciona
          1. 📁 Comportamiento del directorio de salida
        4. Instalación y uso
          1. Paquete NPM
          2. Herramienta: create_image
          3. Herramienta: create_image_edit
        5. 🔧 Solución de problemas
          1. 🚨 Problemas comunes
          2. 🔍 Manejo y generación de informes de errores
        6. 📄 Licencia
          1. 🙏 Agradecimientos

            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