GuruPDF

GuruPDF MCP — convierte PDFs y más de 100 formatos de archivo desde tu agente de IA

Un Model Context Protocol (MCP) server gratuito que permite a Claude, Cursor, VS Code, Windsurf y otros agentes de IA convertir, comprimir, fusionar, dividir y editar PDFs — y convertir entre más de 100 formatos de archivo (Word, Excel, PowerPoint, JPG, PNG, HEIC, libros electrónicos y más), directamente en tu propia máquina. Desarrollado por GuruPDF.

Idiomas: English · Español · Français · Deutsch · 中文 · Русский · Українська · Polski · Nederlands · Türkçe · Čeština · Ελληνικά · العربية

Pídele a tu asistente: "comprime este PDF", "convierte invoice.docx en un PDF" o "fusiona estos tres archivos" — y convertirá los archivos directamente en tu máquina.

• 🗂️ 126 herramientas — PDF ⇄ Word/Excel/PowerPoint, imágenes, libros electrónicos, OCR, comprimir, fusionar, dividir, rotar, proteger, marca de agua y más.
• 💻 Funciona con tus archivos locales — lee y escribe archivos en disco, sin carga/descarga manual.
• 🆓 Gratis para empezar — cada cuenta recibe créditos diarios. No se requiere tarjeta de crédito.

Instalación

Necesitas Node.js 18+ y una clave API de GuruPDF gratuita:

1. Regístrate en gurupdf.com.
2. Abre Perfil → Tokens de API y crea un token.
3. Añade el servidor a tu agente con esa clave (configuraciones abajo). Sin paso de instalación — npx lo descarga en la primera ejecución.

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your_token_here" }
    }
  }
}

Cursor

~/.cursor/mcp.json (o .cursor/mcp.json en un proyecto):

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your_token_here" }
    }
  }
}

VS Code

.vscode/mcp.json:

{
  "servers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your_token_here" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your_token_here" }
    }
  }
}

Herramientas

Herramienta	Qué hace
convert_file	Convierte/procesa un archivo local (o URL). Dale una entrada y un formato de destino (pdf, png, docx…) o un slug de herramienta (compress-pdf, merge-pdf…). Guarda el resultado en disco.
get_status	Comprueba un trabajo de conversión por id y descarga el resultado cuando esté listo (para trabajos largos como vídeo).
list_conversions	Enumera conversiones/herramientas compatibles, opcionalmente filtradas por un formato de entrada.
check_credits	Muestra los créditos restantes y cómo obtener más.

Ejemplos

"Comprime ~/Documents/report.pdf." → convert_file(input: "~/Documents/report.pdf", to: "compress-pdf")

"Convierte invoice.docx a PDF." → convert_file(input: "invoice.docx", to: "pdf")

"Fusiona a.pdf y b.pdf en uno solo." → convert_file(input: ["a.pdf", "b.pdf"], to: "merge-pdf")

"Protege este PDF con contraseña hunter2." → convert_file(input: "secret.pdf", to: "protect-pdf", options: { password: "hunter2" })

"Guarda esta página web como PDF: https://example.com" → convert_file(input: "https://example.com", to: "url-to-pdf")

Plan gratuito y créditos

Cada herramienta cuesta unos pocos créditos. Las cuentas gratuitas reciben créditos diarios (se renuevan cada día) y 2 conversiones/minuto, 10/día. Cuando se agotan, el asistente te lo indicará — puedes esperar a la renovación diaria o recargar / actualizar. Las conversiones se ejecutan en los servidores de GuruPDF; los archivos se eliminan automáticamente en menos de una hora.

Configuración

Variable de entorno	Valor por defecto	Notas
GURUPDF_API_KEY	—	Requerido. Tu token de API desde Perfil → Tokens de API.
GURUPDF_API_URL	https://gurupdf.com/api/v1	Sobrescribe solo para autoalojado / staging.

Enlaces

• Glama: gurupdf-mcp en Glama

• Página de inicio: gurupdf.com/mcp
• Guía: Convierte archivos en Claude y Cursor con el GuruPDF MCP
• Sitio web: gurupdf.com
• Documentación API: gurupdf.com/api/docs
• Precios: gurupdf.com/pricing

Licencia

MIT