remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Integrates with Replicate's 'black-forest-labs/flux-schnell' model to generate images from text prompts

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

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

Manejo de errores

El servidor maneja los siguientes tipos de errores:

Errores de validación (parámetros no válidos)
Errores de API (Replicar problemas de API)
Errores del servidor (sistema de archivos, permisos)
Errores desconocidos (problemas inesperados)

Cada respuesta de error incluye:

Código de error
Mensaje legible para humanos
Información detallada del error

Licencia

ISC

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

generate-image

Permite a los usuarios generar imágenes a partir de indicaciones de texto utilizando el modelo de Replicate, con parámetros configurables y total conformidad con el protocolo MCP.

Related Resources

Reddit Discussion about this server

Image Generation MCP Server