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
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:
- Ve a claude.ai > Configuración > Conectores
- Haz clic en Agregar conector personalizado
- URL:
https://mcp.pictify.io - 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:
- Regístrate o inicia sesión en pictify.io
- Ve a Tokens de API
- 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
| Herramienta | Descripción |
|---|---|
pictify_create_image | Genera una imagen desde HTML/CSS, una captura de URL o una plantilla |
pictify_get_image | Obtén detalles de una imagen específica por ID |
Historial de renderizado
| Herramienta | Descripción |
|---|---|
pictify_list_renders | Lista todo lo renderizado — imágenes, GIFs, PDFs y videos en un solo feed |
Gestión de plantillas
| Herramienta | Descripción |
|---|---|
pictify_list_templates | Lista plantillas guardadas con filtrado y paginación |
pictify_get_template | Obtén detalles de una plantilla |
pictify_get_template_variables | Obtén definiciones y tipos de variables de plantilla |
pictify_render_template | Renderiza una plantilla con variables — imágenes y PDFs (format: 'pdf') |
pictify_multi_size_render | Renderiza una plantilla en varios tamaños en una sola llamada |
pictify_create_template | Crea una nueva plantilla (HTML o FabricJS) |
pictify_update_template | Actualiza una plantilla existente |
pictify_delete_template | Elimina una plantilla |
pictify_validate_expression | Verifica que una expresión {{ }} se analice correctamente antes de usarla |
pictify_list_expression_functions | Lista las funciones disponibles dentro de las expresiones |
Operaciones por lotes
| Herramienta | Descripción |
|---|---|
pictify_batch_render | Inicia un trabajo de renderizado por lotes (hasta 100 elementos, asíncrono) |
pictify_get_batch_results | Verifica el estado del trabajo por lotes y obtén las URLs de resultados |
pictify_cancel_batch | Cancela un trabajo por lotes en ejecución |
Video
| Herramienta | Descripción |
|---|---|
pictify_list_video_templates | Lista tus plantillas de video Remotion |
pictify_get_video_template | Obtén una plantilla de video completa |
pictify_get_video_template_variables | Descubre las variables que espera una plantilla de video |
pictify_render_video | Renderiza una plantilla de video a MP4 o GIF |
pictify_create_video_template | Sube tu propia escena Remotion como plantilla |
pictify_generate_video_template | Genera una plantilla de video desde un prompt de texto |
pictify_update_video_template | Actualiza el nombre, tamaño, duración o código de una plantilla de video |
pictify_duplicate_video_template | Copia una plantilla de video |
pictify_delete_video_template | Elimina una plantilla de video |
Configuración
| Variable | Descripción | Predeterminado |
|---|---|---|
PICTIFY_API_KEY | Tu clave API de Pictify (requerida para modo stdio) | — |
PICTIFY_BASE_URL | URL base de API personalizada | https://api.pictify.io |
PICTIFY_DEBUG | Habilita registro detallado en stderr | false |
PICTIFY_MCP_SOURCE | Slug 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_DISABLED | Establece a 1, true o yes para no enviar análisis de uso en absoluto | false |
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