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.

🚀 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

You must be authenticated.

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

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
              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