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
  }
}