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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

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

Ideogram MCP Server
Sunwood-ai-labs
A
security
F
license
A
quality
A Model Context Protocol server that provides image generation capabilities using the Ideogram API, allowing users to create images from text prompts with customizable parameters.
Last updated -
1
9
4
TypeScript
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
4
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 Generation MCP Server
GongRzhe
-
security
A
license
-
quality
Provides image generation capabilities for Claude using the Replicate Flux model, allowing users to create images from text prompts with customizable parameters like aspect ratio and output format.
Last updated -
80
33
JavaScript
MIT License

View all related MCP servers

Image Generation MCP Server