Papyrio PDF Tools

Comprime, convierte, fusiona, divide y aplica OCR a PDFs en tu propia máquina. Lee y escribe archivos locales, por lo que un asistente puede encadenar operaciones sin subir y descargar entre cada paso.

GitHub

Documentación

papyrio-mcp

Un servidor MCP para la API de PDF de Papyrio. Permite que un asistente comprima, combine, aplique OCR y convierta PDFs en tu propia máquina, leyendo y escribiendo archivos locales, de modo que el trabajo de varios pasos no implique subir y descargar entre cada paso.

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

son cuatro llamadas a herramientas que el asistente realiza por sí mismo.

Instalación

Añade esto a tu configuración de 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"]
    }
  }
}

Reinicia Claude Desktop. Las herramientas aparecen bajo el icono de conector.

Clave de API

El servidor funciona sin una, medido como tráfico web gratuito ordinario: tres operaciones al día por dirección IP. Suficiente para ver si es útil.

Para uso real, suscríbete en RapidAPI y pasa la clave:

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

El nivel gratuito de RapidAPI es de 50 solicitudes al mes y no requiere tarjeta.

Herramientas

Herramienta	Función	Escribe
`compress_pdf`	Reduce un PDF, 30–80% en archivos con muchas imágenes	`.pdf`
`merge_pdfs`	Une 2–10 PDFs en orden	`.pdf`
`split_pdf`	Separa cada página en su propio archivo	`.zip`
`extract_pdf_text`	Devuelve la capa de texto como UTF-8	`.txt`
`pdf_to_word`	Reconstruye el documento como un .docx editable	`.docx`
`pdf_to_jpg`	Renderiza cada página como JPG	`.zip`
`ocr_pdf`	Añade una capa de texto buscable a un escaneo	`.pdf`
`office_to_pdf`	Word, PowerPoint o Excel a PDF	`.pdf`
`image_to_pdf`	Envuelve un JPG, PNG o WebP en una página PDF	`.pdf`
`webpage_to_pdf`	Renderiza una URL pública en un navegador sin interfaz	`.pdf`
`protect_pdf`	Cifra con AES-256	`.pdf`
`unlock_pdf`	Elimina una contraseña que ya conoces	`.pdf`

Cada herramienta toma rutas absolutas. output_path es opcional y por defecto usa el nombre de entrada con un sufijo -papyrio — excepto webpage_to_pdf, que no tiene archivo de entrada del que derivar un nombre y por lo tanto lo requiere.

Añadir una herramienta

Añade una entrada a src/tools.ts. La herramienta MCP, su esquema de entrada y la llamada HTTP se generan a partir de ella.

Pruebas

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

Impulsa las doce herramientas sobre el protocolo MCP real contra la API en vivo y comprueba los bytes mágicos del archivo devuelto, de modo que un cuerpo de error JSON llamado .pdf falla en lugar de pasar. Sin una clave, se ejecuta en el nivel de invitado, donde tres operaciones al día significa que la mayoría de los casos encontrarán rate_limit_exceeded.

Desarrollo

npm install
npm run build

Apunta tu configuración a la compilación local mientras trabajas en ello:

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

Privacidad: los archivos se envían a la API de Papyrio, se procesan en memoria y se descartan cuando se envía la respuesta. No se almacena nada.

Licencia

MIT