Papyrio PDF Tools

Comprima, converta, mescle, divida e faça OCR de PDFs na sua própria máquina. Lê e grava arquivos locais, então um assistente pode encadear operações sem precisar enviar e baixar arquivos a cada etapa.

GitHub

Documentação

papyrio-mcp

Um servidor MCP para a API de PDF do Papyrio. Ele permite que um assistente compacte, mescle, faça OCR e converta PDFs na sua própria máquina, lendo e gravando arquivos locais, para que trabalhos de várias etapas não signifiquem enviar e baixar arquivos entre cada etapa.

OCR every scan in ~/invoices, merge them into one PDF, compress it under 5 MB

são quatro chamadas de ferramenta que o assistente faz por conta própria.

Instalação

Adicione isto à sua configuração do Claude Desktop:

macOS ~/Library/Application Support/Claude/claude_desktop_config.json Windows %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "papyrio": {
      "command": "npx",
      "args": ["-y", "papyrio-mcp"]
    }
  }
}

Reinicie o Claude Desktop. As ferramentas aparecem sob o ícone do conector.

Chave da API

O servidor funciona sem uma, medido como tráfego web gratuito comum: três operações por dia por endereço IP. Suficiente para ver se é útil.

Para uso real, assine no RapidAPI e passe a chave:

{
  "mcpServers": {
    "papyrio": {
      "command": "npx",
      "args": ["-y", "papyrio-mcp"],
      "env": { "PAPYRIO_API_KEY": "your-rapidapi-key" }
    }
  }
}

O nível gratuito do RapidAPI é de 50 solicitações por mês e não exige cartão.

Ferramentas

Ferramenta	O que faz	Grava
`compress_pdf`	Reduz um PDF, 30–80% em arquivos com muitas imagens	`.pdf`
`merge_pdfs`	Junta 2–10 PDFs em ordem	`.pdf`
`split_pdf`	Separa cada página em seu próprio arquivo	`.zip`
`extract_pdf_text`	Retorna a camada de texto como UTF-8	`.txt`
`pdf_to_word`	Reconstrói o documento como um .docx editável	`.docx`
`pdf_to_jpg`	Renderiza cada página como JPG	`.zip`
`ocr_pdf`	Adiciona uma camada de texto pesquisável a uma digitalização	`.pdf`
`office_to_pdf`	Word, PowerPoint ou Excel para PDF	`.pdf`
`image_to_pdf`	Envolve um JPG, PNG ou WebP em uma página PDF	`.pdf`
`webpage_to_pdf`	Renderiza uma URL pública em um navegador headless	`.pdf`
`protect_pdf`	Criptografa com AES-256	`.pdf`
`unlock_pdf`	Remove uma senha que você já conhece	`.pdf`

Toda ferramenta aceita caminhos absolutos. output_path é opcional e usa por padrão o nome da entrada com um sufixo -papyrio — exceto webpage_to_pdf, que não tem arquivo de entrada para derivar um nome e, portanto, exige isso.

Adicionando uma ferramenta

Adicione uma entrada em src/tools.ts. A ferramenta MCP, seu esquema de entrada e a chamada HTTP são todos gerados a partir dela.

Testes

npm run build
PAPYRIO_API_KEY=your-key node smoke.mjs

Aciona todas as doze ferramentas pelo protocolo MCP real contra a API ao vivo e verifica os bytes mágicos do arquivo retornado, para que um corpo de erro JSON chamado .pdf falhe em vez de passar. Sem uma chave, ele roda no nível de convidado, onde três operações por dia significa que a maioria dos casos encontrará rate_limit_exceeded.

Desenvolvimento

npm install
npm run build

Aponte sua configuração para o build local enquanto trabalha nele:

{
  "mcpServers": {
    "papyrio": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/dist/index.js"]
    }
  }
}

Privacidade: os arquivos são enviados para a API do Papyrio, processados em memória e descartados quando a resposta é enviada. Nada é armazenado.

Licença

MIT