mcp-mockuuups

Servidor MCP para Mockuuups Studio — busca entre ~5.300 maquetas de dispositivos e impresiones y luego renderiza una captura de pantalla o tu propia imagen en ellas.

Un único diseño — la guía de ciudad de Berlín WTDIB — renderizado en cuatro maquetas a partir de una sola sesión de fotos, de modo que la estancia permanece fija mientras cambia el dispositivo. Dos llamadas a herramientas, sin alojamiento de imágenes en ningún sitio.

Por qué existe esto

Mockuuups ofrece su propio servidor MCP alojado en https://mcp.mockuuups.studio/mcp. Expone una única herramienta generate_mockup que necesita un identificador de maqueta que ya conozcas y una imagen que ya hayas alojado en algún lugar público.

Este servidor, en cambio, envuelve la API REST subyacente y cierra las dos carencias que hacían incómodo el servidor alojado en la práctica:

• Puedes buscar. El endpoint del catálogo original no acepta ningún parámetro de búsqueda — q, type, family y tag se ignoran silenciosamente y cada solicitud devuelve la misma página sin filtrar. Todo el catálogo se obtiene una vez y se busca localmente, de modo que "una tableta sobre un escritorio" o "póster" realmente encuentra algo.

• Puedes subir imágenes. Mockuuups solo renderiza desde una URL. Pasa a este servidor los bytes de imagen sin procesar y él los coloca en un enlace efímero e imposible de adivinar para que el renderizador los obtenga, de modo que un diseño local no necesita bucket, ni CDN, ni alojamiento.

Renderizar una imagen que tienes en local

Mockuuups solo renderiza desde una URL. Pasa image_base64 y este servidor coloca los bytes en un enlace efímero e imposible de adivinar, permite que el renderizador lo obtenga y deja que expire — sin bucket, sin CDN, sin cuenta de alojamiento.

El renderizado del iPad de arriba, subido desde el disco y renderizado en un póster A3 enmarcado.

Related MCP server: Store Screenshot Generator MCP

Herramientas

Renderizar un diseño en varios dispositivos

Las escenas fotografiadas juntas comparten una etiqueta, así que la forma de conseguir un aspecto coherente entre dispositivos es buscar una y luego filtrar por su etiqueta:

search_mockups(query="ipad", tag="update-august-2024-meeting-room")
create_mockups(
    mockup_ids=["Zkn1GMTfiAFX5ZOn", "Zkn2DsTfiAFX5ZPD", "Zkn15MTfiAFX5ZO_"],
    screenshot_url="https://wtdib.cdit-works.de/",
)

Configuración

Consulta .env.example. Las dos que importan son:

• MOCKUUUPS_API_KEY — una clave de desarrollador de mockuuups.studio/developers.

• PUBLIC_BASE_URL — el origen público de este servidor. Las subidas lo necesitan, porque el renderizador de Mockuuups recupera la imagen almacenada a través de internet público. Las renderizaciones por captura de pantalla y por URL de imagen funcionan sin él.

Límites del plan que conviene conocer

La API factura en créditos: una renderización = 1 crédito, +1 por captura de pantalla de sitio web, +1 por alta resolución. Solo se cobran las renderizaciones exitosas.

Dos comportamientos te van a afectar si no los conoces:

• Omitir size implica alta resolución, lo que falla de forma rotunda con feature-not-available en cualquier plan que no la tenga. Este servidor siempre envía size explícitamente, limitado por MOCKUUUPS_MAX_SIZE (por defecto 1000, el límite del plan Trial). Auméntalo cuando la cuenta tenga la característica hires.

• En los planes con cdn-temporary, los enlaces de entrega caducan después de ~24 horas. Descarga cualquier cosa que valga la pena conservar. account_status informa de ello.

Desarrollo

uv sync
uv run pytest
uv run mcp-mockuuups          # stdio
TRANSPORT=http uv run mcp-mockuuups   # streamable-http on /mcp

Licencia

MIT