@mcp-z/mcp-pdf

@mcp-z/mcp-pdf

Crie documentos e layouts em PDF, renderize páginas em PNG e meça texto através do MCP. O servidor roda localmente e não requer chave de API.

Requer Node.js >=22.13. Os exemplos usam npx, incluído com npm, para executar este servidor e @mcp-z/cli.

Transportes

O MCP suporta stdio e HTTP.

Ambos os transportes suportam as revisões de protocolo de 2025 e 2026-07-28. A revisão de 2026 é sem estado, então clientes que a utilizam não enviam handshake initialize ou ID de sessão.

Salve uma destas configurações como .mcp.json no diretório onde você executará os comandos.

Stdio

{
  "mcpServers": {
    "pdf": {
      "command": "npx",
      "args": ["-y", "@mcp-z/mcp-pdf"]
    }
  }
}

HTTP

{
  "mcpServers": {
    "pdf": {
      "type": "http",
      "url": "http://localhost:9010/mcp",
      "start": {
        "command": "npx",
        "args": ["-y", "@mcp-z/mcp-pdf", "--port=9010"]
      }
    }
  }
}

start é uma extensão usada por npx @mcp-z/cli up para iniciar servidores HTTP para você. O endpoint do MCP é /mcp.

Primeiro uso

# List tools
npx -y @mcp-z/cli inspect --servers pdf --tools

# Create a simple PDF
npx -y @mcp-z/cli call-tool pdf pdf-document '{"content":[{"type":"text","text":"Hello from MCP"}]}'

A ferramenta retorna um URI de arquivo e metadados para o PDF gerado. Consulte a referência completa da ferramenta para parâmetros e exemplos.

Resumo das ferramentas

Ferramenta	Uso
pdf-document	Documentos fluídos com paginação automática
pdf-layout	Layouts posicionados com precisão, como slides e panfletos
pdf-resume	Documentos JSON Resume
pdf-image	Renderizar páginas de PDF em PNG
text-measure	Medir texto antes do layout

Recursos externos

Nenhum.

Prompts

1. busca de recursos

Recursos

• Documentação do PDFKit
• Esquema JSON Resume
• Editor JSON Resume

Documentação

Documentação da API