openai-images-mcp

Genera y edita imágenes con los modelos gpt-image y DALL·E de OpenAI, expuestos como herramientas del Protocolo de Contexto de Modelo (MCP). Compatible con gpt-image-1.5, gpt-image-1, gpt-image-1-mini, dall-e-3 y dall-e-2.

Herramientas

Todos los archivos generados se guardan en el disco. Establece return_image_content: true en cualquier llamada para recibir también las imágenes como bloques de imagen MCP (útil cuando el cliente debe "ver" el resultado, pero añade muchos tokens).

Instalación

npm install
npm run build

Configura tu cliente MCP

Claude Desktop / Claude Code

Añádelo a claude_desktop_config.json (o al archivo .mcp.json de tu proyecto):

{
  "mcpServers": {
    "dalle": {
      "command": "node",
      "args": ["/absolute/path/to/dalle-mcp/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "DALLE_OUTPUT_DIR": "/absolute/path/where/images/save"
      }
    }
  }
}

Variables de entorno

Referencia de herramientas

generate_image

Requerido: prompt.

Opcional: model, size, quality, n, background, output_format, output_compression, moderation, style, user, output_dir, filename_prefix, return_image_content.

Notas específicas del modelo:

• GPT Image (gpt-image-1.5, gpt-image-1, gpt-image-1-mini): tamaños auto|1024x1024|1536x1024|1024x1536, calidades auto|low|medium|high. Soporta background, output_format, output_compression, moderation.

• DALL·E 3: tamaños 1024x1024|1792x1024|1024x1792, calidades standard|hd, n debe ser 1, soporta style.

• DALL·E 2: tamaños 256x256|512x512|1024x1024, calidad standard.

edit_image

Requerido: prompt, images (rutas absolutas, hasta 16 para GPT Image).

Opcional: mask (los píxeles transparentes indican regiones editables), además de las opciones de generación anteriores. DALL·E 3 no admite ediciones.

create_variation

Solo DALL·E 2. Requerido: image (PNG, cuadrado, menos de 4MB).

Opcional: n, size (256x256|512x512|1024x1024), output_dir, filename_prefix, return_image_content.

list_models

Sin argumentos. Devuelve un documento JSON que describe los tamaños, calidades y opciones admitidas de cada modelo; es útil para que el llamador consulte antes de elegir los parámetros.

Desarrollo

npm run dev     # run with tsx, no build step
npm run build   # tsc to dist/
npm start       # node dist/index.js

El servidor habla MCP a través de stdio, por lo que puedes controlarlo con cualquier cliente compatible con MCP o manualmente enviando mensajes JSON-RPC a node dist/index.js.

Notas

• DALL·E 2 y DALL·E 3 están obsoletos por parte de OpenAI y el soporte finaliza el 12-05-2026; prefiere la familia GPT Image.

• Los modelos GPT Image siempre devuelven datos en base64; a los modelos DALL·E también se les solicita en base64 para que los archivos puedan guardarse sin un segundo viaje de ida y vuelta HTTP.