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.
🚀 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.
📚 Referencias
🙏 Créditos