Servidor MCP de generación de imágenes

Una implementación de servidor MCP (Protocolo de contexto de modelo) para generar imágenes utilizando el modelo black-forest-labs/flux-schnell de Replicate.

Lo ideal es utilizarlo con la función MCP de Cursor, pero se puede utilizar con cualquier cliente MCP.

Características

Generar imágenes a partir de indicaciones de texto
Parámetros de imagen configurables (resolución, relación de aspecto, calidad)
Guardar las imágenes generadas en el directorio especificado
Cumplimiento total del protocolo MCP
Manejo de errores y validación

Related MCP server: Together AI Image Server

Prerrequisitos

Node.js 16+
Replicar token de API
SDK de TypeScript para MCP

Configuración

Clonar el repositorio
Instalar dependencias:
npm install
Agregue su token de API de replicación directamente en el código en src/imageService.ts actualizando la constante apiToken :
// No environment variables are used since they can't be easily set in cursor const apiToken = "your-replicate-api-token-here";
Nota: Si lo usa con Claude, puede crear un archivo .env en el directorio raíz y configurar su token de API allí:
REPLICATE_API_TOKEN=your-replicate-api-token-here
Luego construye el proyecto:
npm run build

Uso

Para utilizar con el cursor:

Ir a Configuración
Seleccionar funciones
Desplácese hacia abajo hasta "Servidores MCP"
Haga clic en "Agregar nuevo servidor MCP"
Establezca el tipo en "Comando"
Establezca el comando en: node ./path/to/dist/server.js

Parámetros de API

Parámetro	Tipo	Requerido	Por defecto	Descripción
`prompt`	cadena	Sí	-	Solicitud de texto para la generación de imágenes
`output_dir`	cadena	Sí	-	Ruta del directorio del servidor para guardar las imágenes generadas
`go_fast`	booleano	No	FALSO	Habilitar el modo de generación más rápido
`megapixels`	cadena	No	"1"	Calidad de resolución ("1", "2", "4")
`num_outputs`	número	No	1	Número de imágenes a generar (1-4)
`aspect_ratio`	cadena	No	"1:1"	Relación de aspecto ("1:1", "4:3", "16:9")
`output_format`	cadena	No	"webp"	Formato de imagen ("webp", "png", "jpeg")
`output_quality`	número	No	80	Calidad de compresión (1-100)
`num_inference_steps`	número	No	4	Número de pasos de eliminación de ruido (4-20)

Ejemplo de solicitud

{ "prompt": "black forest gateau cake spelling out 'FLUX SCHNELL'", "output_dir": "/var/output/images", "filename": "black_forest_cake", "output_format": "webp" "go_fast": true, "megapixels": "1", "num_outputs": 2, "aspect_ratio": "1:1" }

Ejemplo de respuesta

{ "image_paths": [ "/var/output/images/output_0.webp", "/var/output/images/output_1.webp" ], "metadata": { "model": "black-forest-labs/flux-schnell", "inference_time_ms": 2847 } }