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)
  • Renderizar vídeos e GIFs animados 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

Claude.ai (Web)

Use o servidor remoto hospedado — sem instalação, sem chave de API:

  1. Acesse claude.ai > Configurações > Conectores
  2. Clique em Adicionar conector personalizado
  3. URL: https://mcp.pictify.io
  4. Clique em Adicionar e depois em Conectar — você fará login no Pictify e aprovará o acesso

Nada precisa ser preenchido nas Configurações Avançadas. A conexão aparecerá em Aplicativos conectados nas suas configurações do Pictify, onde você pode desconectá-la a qualquer momento.

Pré-requisitos para o servidor local

O pacote npm autentica com uma chave de API em vez de login pelo navegador:

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

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 às configurações de MCP do Cursor (Settings > MCP Servers):

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

Windsurf

Adicione às 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 'Começando com 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 'Olá Mundo'."

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_imageGere uma imagem a partir de HTML/CSS, captura de tela de URL ou um modelo
pictify_get_imageObtenha detalhes de uma imagem específica por ID

Histórico de Renderização

FerramentaDescrição
pictify_list_rendersListe tudo o que foi renderizado — imagens, GIFs, PDFs e vídeos em um único feed

Gerenciamento de Modelos

FerramentaDescrição
pictify_list_templatesListe modelos salvos com filtragem e paginação
pictify_get_templateObtenha detalhes de um modelo
pictify_get_template_variablesObtenha definições e tipos de variáveis de um modelo
pictify_render_templateRenderize um modelo com variáveis — imagens e PDFs (format: 'pdf')
pictify_multi_size_renderRenderize um modelo em vários tamanhos em uma única chamada
pictify_create_templateCrie um novo modelo (HTML ou FabricJS)
pictify_update_templateAtualize um modelo existente
pictify_delete_templateExclua um modelo
pictify_validate_expressionVerifique se uma expressão {{ }} é analisada corretamente antes de usá-la
pictify_list_expression_functionsListe as funções disponíveis dentro de expressões

Operações em Lote

FerramentaDescrição
pictify_batch_renderInicie um trabalho de renderização em lote (até 100 itens, assíncrono)
pictify_get_batch_resultsVerifique o status do trabalho em lote e obtenha URLs de resultados
pictify_cancel_batchCancele um trabalho em lote em execução

Vídeo

FerramentaDescrição
pictify_list_video_templatesListe seus modelos de vídeo Remotion
pictify_get_video_templateObtenha um modelo de vídeo completo
pictify_get_video_template_variablesDescubra as variáveis que um modelo de vídeo espera
pictify_render_videoRenderize um modelo de vídeo em MP4 ou GIF
pictify_create_video_templateEnvie sua própria cena Remotion como modelo
pictify_generate_video_templateGere um modelo de vídeo a partir de um prompt de texto
pictify_update_video_templateAtualize o nome, tamanho, duração ou código de um modelo de vídeo
pictify_duplicate_video_templateCopie um modelo de vídeo
pictify_delete_video_templateExclua um modelo de vídeo

Configuração

VariávelDescriçãoPadrão
PICTIFY_API_KEYSua chave de API do Pictify (obrigatória para o modo stdio)—
PICTIFY_BASE_URLURL base personalizada da APIhttps://api.pictify.io
PICTIFY_DEBUGAtive o registro detalhado 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 o Pictify possa atribuir instalações por diretório.unknown
PICTIFY_ANALYTICS_DISABLEDDefina como 1, true ou yes para não enviar nenhuma análise de usofalse

Hospedar o servidor HTTP por conta própria adiciona MCP_PORT, MCP_PUBLIC_URL (a origem pública, usada para construir o documento de metadados de recursos protegidos) e PICTIFY_AUTH_SERVER_URL (o servidor de autorização OAuth para apontar os clientes, com padrão https://api.pictify.io; PICTIFY_AUTH_SERVER também é aceito).

Análise de uso

Este servidor reporta o uso de ferramentas ao PostHog para que possamos ver quais ferramentas os agentes utilizam e quais falham. Cada chamada registra o nome da ferramenta, seus argumentos e resultado, tempo de execução, se houve erro, a intenção declarada, o nome e versão do seu cliente e — quando uma chave de API resolve para uma conta — seu e-mail e plano.

Argumentos e resultados significam o HTML, URLs, prompts e variáveis de modelo que você envia. Se isso não for aceitável para o seu uso, defina PICTIFY_ANALYTICS_DISABLED=1 e nada será enviado.

Atribuição de instalação

Ao enviar @pictify/mcp-server para um diretório MCP, defina PICTIFY_MCP_SOURCE no trecho de instalação para que possamos atribuir inscrições 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 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