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.

security – no known vulnerabilities

license - not found

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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

Related MCP Servers

Together AI Image Server
zym9863
A
security
A
license
A
quality
A MCP server that enables Claude and other MCP-compatible assistants to generate images from text prompts using Together AI's image generation models.
Last updated -
1
2
TypeScript
MIT License
Flux Image MCP Server
ckz
-
security
A
license
-
quality
Provides image generation capabilities using the Flux Schnell model on Replicate, allowing users to create images from text prompts.
Last updated -
1
JavaScript
MIT License
Image-Gen-Server
fengin
-
security
A
license
-
quality
A MCP server that integrates with Cursor IDE to generate images based on text descriptions using JiMeng AI, allowing users to create and save custom images directly within their development environment.
Last updated -
160
Python
MIT License
Image Generator MCP Server
luoshui-coder
-
security
-
license
-
quality
A TypeScript-based MCP server that lets users generate images using OpenAI's dall-e-3 model by providing a prompt and image name.
Last updated -
1

View all related MCP servers

Image Generation MCP Server