Pictify

Servidor MCP para imágenes, GIFs y PDFs generados por IA a partir de HTML/CSS, URLs o plantillas reutilizables. Procesa hasta 100 renders personalizados por lote, prueba variantes A/B.

Documentación

@pictify/mcp-server

npm version MIT License

Un servidor MCP (Model Context Protocol) para Pictify: genera imágenes, GIFs, videos y PDFs desde agentes de IA como Claude, Cursor y Windsurf.

Instalación en una línea. Sin necesidad de código. Pídele a tu asistente de IA que cree imágenes OG, tarjetas para redes sociales, capturas de pantalla, GIFs animados, facturas en PDF, certificados y mucho más, todo desde lenguaje natural.

¿Qué puede hacer?

  • Generar imágenes desde HTML/CSS, URLs o plantillas reutilizables (imágenes OG, tarjetas de Twitter, banners, capturas de producto)
  • Crear GIFs animados desde animaciones CSS o grabando páginas web en vivo
  • Renderizar videos desde plantillas, incluyendo escenas Remotion creadas por agentes
  • Renderizar PDFs desde plantillas: facturas, certificados, informes, etiquetas de envío
  • Generación por lotes de hasta 100 imágenes personalizadas en una sola solicitud (insignias de equipo, pases de evento, catálogos de productos)
  • Sistema de plantillas con más de 50 funciones de expresión para contenido dinámico (condicionales, manipulación de cadenas, formato de fechas)

Funciona con Claude (claude.ai + Claude Code + Claude Desktop), Cursor, Windsurf y cualquier cliente compatible con MCP.

Inicio rápido

Requisitos previos

Obtén tu clave de API:

  1. Regístrate o inicia sesión en pictify.io
  2. Ve a API Tokens
  3. Crea un nuevo token y cópialo

Claude.ai (Web)

Usa el servidor remoto alojado: no se necesita instalación:

  1. Ve a claude.ai > Configuración > Conectores
  2. Haz clic en Agregar conector personalizado
  3. URL: https://mcp.pictify.io
  4. Haz clic en Configuración avanzada
  5. ID de cliente: pictify
  6. Secreto de cliente: pega tu token de API
  7. Haz clic en Agregar

Claude Code

claude mcp add pictify -e PICTIFY_API_KEY=your_api_key -- npx -y @pictify/mcp-server

Claude Desktop

Agrega a tu archivo de configuración:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "pictify": {
      "command": "npx",
      "args": ["-y", "@pictify/mcp-server"],
      "env": {
        "PICTIFY_API_KEY": "your_api_key"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar.

Cursor

Agrega a la configuración de MCP de Cursor (Configuración > Servidores MCP):

{
  "mcpServers": {
    "pictify": {
      "command": "npx",
      "args": ["-y", "@pictify/mcp-server"],
      "env": {
        "PICTIFY_API_KEY": "your_api_key"
      }
    }
  }
}

Windsurf

Agrega a la configuración de MCP de Windsurf:

{
  "mcpServers": {
    "pictify": {
      "command": "npx",
      "args": ["-y", "@pictify/mcp-server"],
      "env": {
        "PICTIFY_API_KEY": "your_api_key"
      }
    }
  }
}

Ejemplos

Prueba estos prompts después de conectarte:

Crear una tarjeta para redes sociales:

"Crea una imagen de tarjeta de Twitter para mi publicación de blog titulada 'Getting Started with MCP' con un fondo degradado azul, 1200x630."

Capturar un sitio web:

"Toma una captura de pantalla de stripe.com a 1440x900."

Renderizar una plantilla:

"Lista mis plantillas y renderiza la plantilla blog-header con el título 'Hello World'."

Generar imágenes por lotes:

"Usa mi plantilla team-badge para generar imágenes para estos 10 miembros del equipo: ..."

Crear una factura en PDF:

"Renderiza mi plantilla de factura como PDF con el nombre de la empresa 'Acme Inc', el monto '$1,500' y la fecha 'March 2026'."

Herramientas disponibles

Generación de imágenes

HerramientaDescripción
pictify_create_imageGenera una imagen desde HTML/CSS, una captura de URL o una plantilla
pictify_create_canvas_imageGenera una imagen desde datos JSON de canvas FabricJS
pictify_list_imagesLista imágenes generadas previamente
pictify_get_imageObtén detalles de una imagen específica por ID

Creación de GIFs

HerramientaDescripción
pictify_create_gifCrea un GIF animado desde HTML con animaciones CSS
pictify_capture_gifGraba un GIF desde una página web en vivo a lo largo del tiempo
pictify_list_gifsLista GIFs generados previamente
pictify_get_gifObtén detalles de un GIF específico por ID

Generación de PDFs

HerramientaDescripción
pictify_render_pdfGenera un PDF de una sola página desde una plantilla
pictify_render_multi_page_pdfGenera un PDF de varias páginas desde una plantilla
pictify_list_pdf_presetsLista los ajustes preestablecidos de tamaño de página PDF disponibles

Gestión de plantillas

HerramientaDescripción
pictify_list_templatesLista plantillas guardadas con filtrado y paginación
pictify_get_templateObtén detalles de una plantilla
pictify_get_template_variablesObtén definiciones y tipos de variables de plantilla
pictify_render_templateRenderiza una plantilla con variables (admite variantes de diseño)
pictify_create_templateCrea una nueva plantilla (HTML o FabricJS)
pictify_update_templateActualiza una plantilla existente
pictify_delete_templateElimina una plantilla

Operaciones por lotes

HerramientaDescripción
pictify_batch_renderInicia un trabajo de renderizado por lotes (hasta 100 elementos, asíncrono)
pictify_get_batch_resultsVerifica el estado del trabajo por lotes y obtén las URLs de los resultados
pictify_cancel_batchCancela un trabajo por lotes en ejecución

Configuración

VariableDescripciónPredeterminado
PICTIFY_API_KEYTu clave de API de Pictify (requerida para el modo stdio)
PICTIFY_BASE_URLURL base de API personalizadahttps://api.pictify.io
PICTIFY_DEBUGHabilita el registro detallado en stderrfalse
PICTIFY_MCP_SOURCESlug que identifica desde dónde se instaló este servidor MCP (por ejemplo, mcp.so, glama, smithery, claude_desktop_gallery, github). Se envía como X-Pictify-MCP-Source en cada llamada a la API para que Pictify pueda atribuir las instalaciones por directorio.unknown

Atribución de instalación

Cuando envíes @pictify/mcp-server a un directorio de MCP, establece PICTIFY_MCP_SOURCE en el fragmento de instalación para que podamos atribuir los registros a ese listado. Ejemplo para la entrada del directorio mcp.so:

{
  "mcpServers": {
    "pictify": {
      "command": "npx",
      "args": ["-y", "@pictify/mcp-server"],
      "env": {
        "PICTIFY_API_KEY": "your_api_key",
        "PICTIFY_MCP_SOURCE": "mcp.so"
      }
    }
  }
}

Para el servidor remoto alojado (https://mcp.pictify.io), pasa el slug como un parámetro de consulta en la URL del conector en su lugar: el servidor lo persiste en la sesión de OAuth:

https://mcp.pictify.io?source=mcp.so

Slugs aceptados: letras minúsculas, dígitos, ., -, _, hasta 64 caracteres. Cualquier otra cosa se descarta a unknown.

Desarrollo

git clone https://github.com/pictify-io/pictify-mcp.git
cd pictify-mcp
npm install
npm run build

Prueba con MCP Inspector:

PICTIFY_API_KEY=your_key npm run inspector

Licencia

MIT