A side-by-side look at the Gurupdf MCP and Pdf4vllm MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose Gurupdf MCP for file systems work as a local process; choose Pdf4vllm for file systems as a local process. You can also run both side by side in one mcpServers block.
GURUPDF_API_KEY.convert_file, get_status, list_conversions.list_pdfs, read_pdf, grep_pdf.Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | File Systems | File Systems |
| Quality signal | 57/100 · Good | 45/100 · Fair |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | API key required | Not declared |
| Pricing | Freemium | Not declared |
| Required env vars | GURUPDF_API_KEY | None listed |
| Verified owner | Community listing | Community listing |
| GitHub stars | 2 | 0 |
| Directory activity | 4 views 0 installs 0 upvotes | 0 views 0 installs 0 upvotes |
| Tools | 4 | 3 |
| Full listing | View Gurupdf MCP | View Pdf4vllm |
convert_fileConvert or process a local file (or URL) with GuruPDF. Convert between 100+ formats (PDF ⇄ Word/Excel/PowerPoint, images, ebooks, etc.) or run a PDF tool (compress, merge, split, rotate, protect, watermark, OCR…). Saves the result next to the input and returns the path.get_statusCheck a GuruPDF conversion job by its id (uuid). If it's finished, downloads the result to disk.list_conversionsList the conversions and tools GuruPDF supports, optionally filtered by an input file format.check_creditsShow how many GuruPDF credits the user has left, and how to get more.list_pdfsFind PDF files with glob filtering (`name_pattern`)read_pdfExtract PDF content as ordered blocksgrep_pdfSearch text in PDFs using pdfgrep (requires `pdfgrep` installed)Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
{
"mcpServers": {
"gurupdf-gurupdf-mcp": {
"command": "npx",
"args": [
"-y",
"gurupdf-mcp"
],
"env": {
"GURUPDF_API_KEY": "YOUR_GURUPDF_API_KEY_HERE"
}
}
}
}
{
"mcpServers": {
"pdf4vllm": {
"command": "uvx",
"args": [
"pdf4vllm-mcp"
]
}
}
}