🚀 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-mcpRelated MCP server: Image Toolkit MCP Server
🔌 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-mcpO 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ámetro | Tipo | Requerido | Descripción |
| cadena | Sí | La descripción del texto de la imagen a generar (máximo 32.000 caracteres) |
| cadena | No | Tamaño de la imagen: "1024x1024" (predeterminado), "1536x1024" o "1024x1536" |
| cadena | No | Calidad de imagen: "alta" (predeterminada), "media" o "baja" |
| entero | No | Número de imágenes a generar (1-10, predeterminado: 1) |
| cadena | No | Estilo de fondo: "transparente", "opaco" o "automático" (predeterminado) |
| cadena | No | Formato de salida: "png" (predeterminado), "jpeg" o "webp" |
| entero | No | Nivel de compresión (0-100, predeterminado: 0) |
| cadena | No | Identificador de usuario para el seguimiento del uso de OpenAI |
| cadena | No | Nivel 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ámetro | Tipo | Requerido | Descripción |
| cadena, objeto o matriz | Sí | Las imágenes a editar (cadena base64 u objeto de ruta de archivo) |
| cadena | Sí | La descripción del texto de la edición deseada (máximo 32.000 caracteres) |
| cadena u objeto | No | La máscara que define las áreas a editar (cadena base64 u objeto de ruta de archivo) |
| cadena | No | Tamaño de la imagen: "1024x1024" (predeterminado), "1536x1024" o "1024x1536" |
| cadena | No | Calidad de imagen: "alta" (predeterminada), "media" o "baja" |
| entero | No | Número de imágenes a generar (1-10, predeterminado: 1) |
| cadena | No | Estilo de fondo: "transparente", "opaco" o "automático" (predeterminado) |
| cadena | No | Identificador 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:
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
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.
