Image Generator MCP Server

Servidor MCP de Generador de Imágenes

Un servidor de Model Context Protocol (MCP) que genera imágenes de prueba con ancho, alto y color personalizables. Guarda las imágenes como archivos PNG en rutas de archivo especificadas.

Características

• Genera imágenes de prueba con dimensiones especificadas (1-4096 píxeles)
• Soporte para formato de color hexadecimal (por ejemplo, #FF0000, #f00)
• Superposición automática de texto que muestra las dimensiones de la imagen
• Texto de etiqueta personalizado opcional mostrado en la esquina superior izquierda
• Selección inteligente de color de contraste para texto legible
• Guarda las imágenes como archivos PNG en rutas de archivo especificadas
• Crea automáticamente directorios si no existen

Instalación

1. Clona o descarga este repositorio
2. Instala las dependencias:

npm install

3. Compila el servidor:

npm run build

4. Añade el servidor a tu configuración de MCP:

Para VSCode:

{
    "servers": {
        "Image Placeholder Gen": {
            "type": "stdio",
            "command": "node",
            "args": [
                "~/mcp_servers/image-gen/build/index.js"
            ]
        }
    }
}

Para Claude Desktop:

{
  "mcpServers": {
    "image-gen": {
      "command": "node",
      "args": ["/path/to/image-gen/build/index.js"]
    }
  }
}

Uso

El servidor proporciona una herramienta:

generate_test_image

Genera una imagen de prueba con los parámetros especificados.

Parámetros:

• width (número): Ancho de la imagen en píxeles (1-4096)
• height (número): Alto de la imagen en píxeles (1-4096)
• color (cadena): Color de la imagen como código hexadecimal (por ejemplo, #FF0000 o #f00)
• filepath (cadena): Ruta completa donde se debe guardar la imagen PNG
• label (cadena, opcional): Texto personalizado para mostrar en la esquina superior izquierda de la imagen

Ejemplo:

{
  "name": "generate_test_image",
  "arguments": {
    "width": 400,
    "height": 300,
    "color": "#3498db",
    "filepath": "/tmp/test_image.png",
    "label": "My Custom Label"
  }
}

Devuelve:

• Confirmación de texto de que la imagen se generó y guardó correctamente

Formato de Color

La herramienta admite formato de color hexadecimal:

• Colores hexadecimales: #FF0000, #f00

Pruebas

Ejecuta el script de prueba para verificar que el servidor funciona:

npm run build
npm test

Dependencias

• Biblioteca canvas de Node.js para la generación de imágenes
• SDK de Model Context Protocol

Notas

• Las dimensiones máximas de imagen están limitadas a 4096x4096 píxeles por rendimiento
• Las imágenes generadas incluyen una superposición de texto con las dimensiones para facilitar la identificación
• El color del texto se elige automáticamente para un contraste óptimo con el fondo
• El servidor crea automáticamente directorios si no existen en la ruta de archivo especificada

Contribuciones

¡No dudes en enviar problemas y solicitudes de mejora!