GuruPDF

Converta, comprima, mescle e faça OCR de PDFs e mais de 100 formatos de arquivo a partir de qualquer agente de IA — 126 ferramentas via a API do GuruPDF.

GitHub

Experimente este MCPPatrocinado

Documentação

GuruPDF MCP — converta PDFs e mais de 100 formatos de arquivo a partir do seu agente de IA

Um servidor Model Context Protocol (MCP) gratuito que permite ao Claude, Cursor, VS Code, Windsurf e outros agentes de IA converter, compactar, mesclar, dividir e editar PDFs — e converter entre mais de 100 formatos de arquivo (Word, Excel, PowerPoint, JPG, PNG, HEIC, ebooks e muito mais), direto na sua própria máquina. Desenvolvido pela GuruPDF.

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

Pergunte ao seu assistente: "compacte este PDF", "transforme invoice.docx em PDF" ou "mescle estes três arquivos" — e ele converte os arquivos direto na sua máquina.

🗂️ 126 ferramentas — PDF ⇄ Word/Excel/PowerPoint, imagens, ebooks, OCR, compactar, mesclar, dividir, girar, proteger, marca d'água e muito mais.
💻 Funciona com seus arquivos locais — lê e grava arquivos no disco, sem upload/download manual.
🆓 Grátis para começar — toda conta recebe créditos diários. Sem necessidade de cartão de crédito.

Instalação

Você precisa de Node.js 18+ e uma chave GuruPDF API gratuita:

Cadastre-se em gurupdf.com.
Abra Perfil → Tokens de API e crie um token.
Adicione o servidor ao seu agente com essa chave (configurações abaixo). Sem etapa de instalação — o npx o busca na primeira execução.

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 (ou .cursor/mcp.json em um projeto):

{
  "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" }
    }
  }
}

Ferramentas

Ferramenta	O que faz
`convert_file`	Converte/processa um arquivo local (ou URL). Forneça uma entrada e um formato de destino (`pdf`, `png`, `docx`…) ou um slug de ferramenta (`compress-pdf`, `merge-pdf`…). Salva o resultado no disco.
`get_status`	Verifica um trabalho de conversão por id e baixa o resultado quando estiver pronto (para trabalhos longos, como vídeo).
`list_conversions`	Lista conversões/ferramentas suportadas, opcionalmente filtradas por um formato de entrada.
`check_credits`	Mostra os créditos restantes e como obter mais.

Exemplos

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

"Converta invoice.docx para PDF." → convert_file(input: "invoice.docx", to: "pdf")

"Mescle a.pdf e b.pdf em um só." → convert_file(input: ["a.pdf", "b.pdf"], to: "merge-pdf")

"Proteja este PDF com senha hunter2." → convert_file(input: "secret.pdf", to: "protect-pdf", options: { password: "hunter2" })

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

Plano gratuito e créditos

Cada ferramenta custa alguns créditos. Contas gratuitas recebem créditos diários (renovados todos os dias) e 2 conversões/minuto, 10/dia. Quando os créditos acabarem, o assistente avisará — você pode aguardar a renovação diária ou recarregar / fazer upgrade. As conversões são executadas nos servidores da GuruPDF; os arquivos são excluídos automaticamente em até uma hora.

Configuração

Variável de ambiente	Padrão	Observações
`GURUPDF_API_KEY`	—	Obrigatória. Seu token de API em Perfil → Tokens de API.
`GURUPDF_API_URL`	`https://gurupdf.com/api/v1`	Substitua apenas para self-hosted / staging.

Licença

MIT