Pictify

Servidor MCP para imagens geradas por IA, GIFs e PDFs a partir de HTML/CSS, URLs ou modelos reutilizáveis. Lote de até 100 renderizações personalizadas, teste A/B de variantes.

Documentação

@pictify/mcp-server

npm version MIT License

Um servidor MCP (Model Context Protocol) para Pictify — gere imagens, GIFs, vídeos e PDFs a partir de agentes de IA como Claude, Cursor e Windsurf.

Instalação em uma linha. Sem necessidade de código. Peça ao seu assistente de IA para criar imagens OG, cards para redes sociais, capturas de tela, GIFs animados, faturas em PDF, certificados e muito mais — tudo a partir de linguagem natural.

O que ele pode fazer?

  • Gerar imagens a partir de HTML/CSS, URLs ou modelos reutilizáveis (imagens OG, cards para Twitter, banners, capturas de tela de produtos)
  • Criar GIFs animados a partir de animações CSS ou gravando páginas web ao vivo
  • Renderizar vídeos a partir de modelos, incluindo cenas Remotion criadas por agentes
  • Renderizar PDFs a partir de modelos — faturas, certificados, relatórios, etiquetas de envio
  • Geração em lote de até 100 imagens personalizadas em uma única solicitação (crachás de equipe, passes de eventos, catálogos de produtos)
  • Sistema de modelos com mais de 50 funções de expressão para conteúdo dinâmico (condicionais, manipulação de strings, formatação de datas)

Funciona com Claude (claude.ai + Claude Code + Claude Desktop), Cursor, Windsurf e qualquer cliente compatível com MCP.

Início Rápido

Pré-requisitos

Obtenha sua chave de API:

  1. Cadastre-se ou faça login em pictify.io
  2. Acesse API Tokens
  3. Crie um novo token e copie-o

Claude.ai (Web)

Use o servidor remoto hospedado — sem necessidade de instalação:

  1. Acesse claude.ai > Configurações > Conectores
  2. Clique em Adicionar conector personalizado
  3. URL: https://mcp.pictify.io
  4. Clique em Configurações avançadas
  5. Client ID: pictify
  6. Client Secret: cole seu token de API
  7. Clique em Adicionar

Claude Code

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

Claude Desktop

Adicione ao seu arquivo de configuração:

  • 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"
      }
    }
  }
}

Reinicie o Claude Desktop após salvar.

Cursor

Adicione nas configurações de MCP do Cursor (Configurações > MCP Servers):

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

Windsurf

Adicione nas configurações de MCP do Windsurf:

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

Exemplos

Experimente estes prompts após conectar:

Criar um card para redes sociais:

"Crie uma imagem de card para Twitter para minha postagem de blog intitulada 'Getting Started with MCP' com fundo em gradiente azul, 1200x630."

Capturar tela de um site:

"Tire uma captura de tela de stripe.com em 1440x900."

Renderizar um modelo:

"Liste meus modelos e renderize o modelo blog-header com o título 'Hello World'."

Gerar imagens em lote:

"Use meu modelo team-badge para gerar imagens para estes 10 membros da equipe: ..."

Criar uma fatura em PDF:

"Renderize meu modelo de fatura como PDF com nome da empresa 'Acme Inc', valor '$1,500' e data 'Março de 2026'."

Ferramentas Disponíveis

Geração de Imagens

FerramentaDescrição
pictify_create_imageGera uma imagem a partir de HTML/CSS, captura de tela de URL ou modelo
pictify_create_canvas_imageGera uma imagem a partir de dados JSON de canvas FabricJS
pictify_list_imagesLista imagens geradas anteriormente
pictify_get_imageObtém detalhes de uma imagem específica por ID

Criação de GIFs

FerramentaDescrição
pictify_create_gifCria GIF animado a partir de HTML com animações CSS
pictify_capture_gifGrava um GIF de uma página web ao vivo ao longo do tempo
pictify_list_gifsLista GIFs gerados anteriormente
pictify_get_gifObtém detalhes de um GIF específico por ID

Geração de PDF

FerramentaDescrição
pictify_render_pdfGera PDF de página única a partir de um modelo
pictify_render_multi_page_pdfGera PDF de múltiplas páginas a partir de um modelo
pictify_list_pdf_presetsLista predefinições de tamanho de página PDF disponíveis

Gerenciamento de Modelos

FerramentaDescrição
pictify_list_templatesLista modelos salvos com filtragem e paginação
pictify_get_templateObtém detalhes do modelo
pictify_get_template_variablesObtém definições e tipos de variáveis do modelo
pictify_render_templateRenderiza um modelo com variáveis (suporta variantes de layout)
pictify_create_templateCria um novo modelo (HTML ou FabricJS)
pictify_update_templateAtualiza um modelo existente
pictify_delete_templateExclui um modelo

Operações em Lote

FerramentaDescrição
pictify_batch_renderInicia trabalho de renderização em lote (até 100 itens, assíncrono)
pictify_get_batch_resultsVerifica o status do trabalho em lote e obtém URLs de resultados
pictify_cancel_batchCancela um trabalho em lote em execução

Configuração

VariávelDescriçãoPadrão
PICTIFY_API_KEYSua chave de API da Pictify (obrigatória no modo stdio)
PICTIFY_BASE_URLURL base personalizada da APIhttps://api.pictify.io
PICTIFY_DEBUGAtiva registro detalhado (logging) em stderrfalse
PICTIFY_MCP_SOURCESlug que identifica de onde este servidor MCP foi instalado (ex.: mcp.so, glama, smithery, claude_desktop_gallery, github). Enviado como X-Pictify-MCP-Source em cada chamada de API para que a Pictify possa atribuir instalações por diretório.unknown

Atribuição de instalação

Ao enviar @pictify/mcp-server para um diretório de MCP, defina PICTIFY_MCP_SOURCE no trecho de instalação para que possamos atribuir cadastros a essa listagem. Exemplo para a entrada do diretório mcp.so:

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

Para o servidor remoto hospedado (https://mcp.pictify.io), passe o slug como parâmetro de consulta na URL do conector — o servidor o persiste na sessão OAuth:

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

Slugs aceitos: letras minúsculas, dígitos, ., -, _, até 64 caracteres. Qualquer outra coisa é descartada para unknown.

Desenvolvimento

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

Teste com o MCP Inspector:

PICTIFY_API_KEY=your_key npm run inspector

Licença

MIT