MCP Image Placeholder Server

MCP Image Placeholder Server

Este es un servidor de Model Context Protocol (MCP) que proporciona una herramienta para generar imágenes placeholder de diferentes proveedores.

Características

• Genera imágenes placeholder de proveedores compatibles
• Admite dos proveedores de imágenes:
  • placehold: Proporciona imágenes placeholder simples
  • lorem-picsum: Proporciona imágenes reales como imágenes placeholder
• Valida los parámetros de entrada
• Devuelve URLs de imágenes para uso inmediato

Requisitos

• Python 3.9+
• uv gestor de paquetes

Instalación

1. Clona este repositorio
2. Configura la configuración para el servidor MCP

Uso

El servidor expone una herramienta:

image_placeholder

Genera una URL de imagen placeholder basada en los parámetros especificados.

Parámetros:

• provider: El proveedor de imágenes a utilizar (placehold o lorem-picsum)
• width: El ancho de la imagen (1-10000)
• height: El alto de la imagen (1-10000)

Devuelve:

• Cadena de URL de la imagen generada

Ejemplo de uso:

# Generate a 300x200 placeholder image
url = image_placeholder(provider="placehold", width=300, height=200)

# Generate a 500px square lorem-picsum image
url = image_placeholder(provider="lorem-picsum", width=500)

Configuración

Para conectar este servidor a Claude for Desktop:

1. Añade lo siguiente a tu claude_desktop_config.json:

   {
       "mcpServers": {
           "image-placeholder": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/ABSOLUTE/PATH/TO/PROJECT",
                   "run",
                   "main.py"
               ]
           }
       }
   }
   

2. Reinicia Claude for Desktop

Para conectar este servidor a Cursor:

1. Abre la Configuración de Cursor
2. Ve a la sección Features
3. Desplázate hacia abajo hasta la sección MCP Servers
4. Haz clic en el botón Add new MCP server
5. Introduce la siguiente información:
   • Nombre: image-placeholder
   • Tipo: command
   • URL del servidor: uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py
6. Haz clic en el botón Add ↵

Solución de problemas

Si la herramienta no se detecta, usa la ruta absoluta del comando uv, por ejemplo:

/ABSOLUTE/PATH/TO/uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py

Ejemplo de uso y salida (Cursor)

Solicitud:

Create a new directory named "example" and a file named output.html.

Then create a single modern looking page using tailwindcss: https://unpkg.com/@tailwindcss/browser@4

Show a nice header, content, and footer, showing a photo gallery.

Save this into output.html

Salida: Salida de ejemplo (Cursor)

Licencia

Licencia MIT