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 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)
  • Renderizar videos y GIFs animados 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 eventos, 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

Claude.ai (Web)

Usa el servidor remoto alojado — sin instalación, sin clave API:

  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 Agregar, luego Conectar — iniciarás sesión en Pictify y aprobarás el acceso

No se necesita nada en Configuración avanzada. La conexión aparece en Aplicaciones conectadas en tu configuración de Pictify, donde puedes desconectarla en cualquier momento.

Requisitos previos para el servidor local

El paquete npm se autentica con una clave API en lugar de un inicio de sesión en el navegador:

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

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 conectar:

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 'Marzo 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_get_imageObtén detalles de una imagen específica por ID

Historial de renderizado

HerramientaDescripción
pictify_list_rendersLista todo lo renderizado — imágenes, GIFs, PDFs y videos en un solo feed

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 — imágenes y PDFs (format: 'pdf')
pictify_multi_size_renderRenderiza una plantilla en varios tamaños en una sola llamada
pictify_create_templateCrea una nueva plantilla (HTML o FabricJS)
pictify_update_templateActualiza una plantilla existente
pictify_delete_templateElimina una plantilla
pictify_validate_expressionVerifica que una expresión {{ }} se analice correctamente antes de usarla
pictify_list_expression_functionsLista las funciones disponibles dentro de las expresiones

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 resultados
pictify_cancel_batchCancela un trabajo por lotes en ejecución

Video

HerramientaDescripción
pictify_list_video_templatesLista tus plantillas de video Remotion
pictify_get_video_templateObtén una plantilla de video completa
pictify_get_video_template_variablesDescubre las variables que espera una plantilla de video
pictify_render_videoRenderiza una plantilla de video a MP4 o GIF
pictify_create_video_templateSube tu propia escena Remotion como plantilla
pictify_generate_video_templateGenera una plantilla de video desde un prompt de texto
pictify_update_video_templateActualiza el nombre, tamaño, duración o código de una plantilla de video
pictify_duplicate_video_templateCopia una plantilla de video
pictify_delete_video_templateElimina una plantilla de video

Configuración

VariableDescripciónPredeterminado
PICTIFY_API_KEYTu clave API de Pictify (requerida para modo stdio)—
PICTIFY_BASE_URLURL base de API personalizadahttps://api.pictify.io
PICTIFY_DEBUGHabilita registro detallado en stderrfalse
PICTIFY_MCP_SOURCESlug que identifica desde dónde se instaló este servidor MCP (p. ej. mcp.so, glama, smithery, claude_desktop_gallery, github). Se envía como X-Pictify-MCP-Source en cada llamada API para que Pictify pueda atribuir instalaciones por directorio.unknown
PICTIFY_ANALYTICS_DISABLEDEstablece a 1, true o yes para no enviar análisis de uso en absolutofalse

El autoalojamiento del servidor HTTP agrega MCP_PORT, MCP_PUBLIC_URL (el origen público, usado para construir el documento de metadatos de recursos protegidos) y PICTIFY_AUTH_SERVER_URL (el servidor de autorización OAuth al que apuntar a los clientes, con valor predeterminado https://api.pictify.io; PICTIFY_AUTH_SERVER también se acepta).

Análisis de uso

Este servidor reporta el uso de herramientas a PostHog para que podamos ver qué herramientas usan los agentes y cuáles fallan. Cada llamada registra el nombre de la herramienta, sus argumentos y resultado, el tiempo, si hubo error, la intención declarada, el nombre y versión de tu cliente y — cuando una clave API se resuelve a una cuenta — tu correo electrónico y plan.

Los argumentos y resultados significan el HTML, URLs, prompts y variables de plantilla que pasas. Si eso no es aceptable para tu uso, establece PICTIFY_ANALYTICS_DISABLED=1 y no se enviará nada.

Atribución de instalación

Cuando envías @pictify/mcp-server a un directorio MCP, establece PICTIFY_MCP_SOURCE en el fragmento de instalación para que podamos atribuir registros a esa lista. 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 remoto alojado (https://mcp.pictify.io), pasa el slug como parámetro de consulta en la URL del conector en su lugar — el servidor lo persiste en la sesión OAuth:

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

Slugs aceptados: letras minúsculas, dígitos, ., -, _, hasta 64 caracteres. Cualquier otra cosa se reduce 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