imagen openai-gpt-mcp

Un servidor de herramientas de Protocolo de Contexto de Modelo (MCP) para las API de generación y edición de imágenes GPT-4o/gpt-image-1 de OpenAI.

Genere imágenes a partir de indicaciones de texto utilizando los últimos modelos de OpenAI.
Edite imágenes (relleno, acabado, composición) con control de indicaciones avanzado.
Admite : Claude Desktop, Cursor, VSCode, Windsurf y cualquier cliente compatible con MCP.

✨ Características

create-image : Genera imágenes a partir de un mensaje, con opciones avanzadas (tamaño, calidad, fondo, etc.).
edit-image : edita o extiende imágenes usando un mensaje y una máscara opcional, admitiendo tanto rutas de archivo como entrada base64.
Salida de archivo : guarde las imágenes generadas directamente en el disco o recíbalas como base64.

Related MCP server: DALL-E MCP Server

🚀 Instalación

git clone https://github.com/SureScaleAI/openai-gpt-image-mcp.git cd openai-gpt-image-mcp yarn install yarn build

🔑 Configuración

Agregar a la configuración de Claude Desktop o VSCode (incluido Cursor/Windsurf):

{ "mcpServers": { "openai-gpt-image-mcp": { "command": "node", "args": ["/absolute/path/to/dist/index.js"], "env": { "OPENAI_API_KEY": "sk-..." } } } }

⚡ Avanzado

Para create-image , configure n para generar hasta 10 imágenes a la vez.
Para edit-image , proporcione una imagen de máscara (ruta de archivo o base64) para controlar dónde se aplican las ediciones.
Consulte src/index.ts para ver todas las opciones.

🧑‍💻 Desarrollo

Fuente de TypeScript: src/index.ts
Construcción: yarn build
Ejecutar: node dist/index.js

📝 Licencia

Instituto Tecnológico de Massachusetts (MIT)

🩺 Solución de problemas

Asegúrese de que su OPENAI_API_KEY sea válida y tenga acceso a la API de imágenes.
Debe tener una organización OpenAI verificada . Tras la verificación, la activación del acceso a la API de imágenes puede tardar entre 15 y 20 minutos.
Las rutas de archivo deben ser absolutas.
Para la salida de archivo, asegúrese de que el directorio sea escribible.
Si ve errores sobre los tipos de archivos, verifique las extensiones y formatos de sus archivos de imagen.

⚠️ Limitaciones y manejo de archivos grandes

Límite de carga útil de 1 MB: Los clientes MCP (incluido Claude Desktop) tienen un límite estricto de 1 MB para las respuestas de la herramienta. Las imágenes grandes (especialmente las de alta resolución o múltiples imágenes) pueden superar fácilmente este límite si se devuelven en base64.
Cambio automático a salida de archivo: Si el tamaño total de la imagen supera 1 MB, la herramienta guardará automáticamente las imágenes en el disco y devolverá la(s) ruta(s) del archivo en lugar de base64. Esto garantiza la compatibilidad y evita errores como result exceeds maximum length of 1048576 .
Ubicación de archivo predeterminada: si no especifica una ruta file_output , las imágenes se guardarán en /tmp (o en el directorio establecido por la variable de entorno MCP_HF_WORK_DIR ) con un nombre de archivo único.
Variable de entorno:
- MCP_HF_WORK_DIR : Configure esta opción para controlar dónde se guardan las imágenes grandes y los archivos de salida. Ejemplo: export MCP_HF_WORK_DIR=/your/desired/dir
Práctica recomendada: para imágenes grandes o de producción, utilice siempre la salida de archivo y asegúrese de que su cliente esté configurado para manejar rutas de archivos.