Tvůj programovací agent ti dokáže vygenerovat kostru aplikace, rozmotat stack trace a hádat se s tebou o tom, jestli odsazovat tabulátory, nebo mezerami. Ale dej mu PDF a požádej ho o editovatelný wordovský dokument — a zasekne se. Soubory leží na tvém disku; model žije v chatu. Nic ty dva nepropojuje.
Přesně kvůli téhle mezeře jsme postavili GuruPDF MCP — malý MCP server, který dává Claude, Cursoru a jakémukoli dalšímu MCP klientovi způsob, jak skutečně převádět soubory. Vlož do promptu cestu, řekni, co chceš, a převedený soubor ti za chvilku přistane zpátky na disku. Žádná obrazovka pro nahrávání, žádné "stáhni to a pak to někam jinam zase nahraj." Prostě "převeď ~/contracts/lease.pdf do Wordu."
Co to vlastně MCP pro převod souborů je
MCP — Model Context Protocol — je ten konektor, díky kterému může AI agent používat nástroje mimo svou vlastní hlavu. Server vystaví pár akcí; agent je zavolá, když je tvůj prompt potřebuje. Existují MCP servery pro databáze, prohlížeče, GitHub.
Pro soubory ale žádný pořádný nebyl. Takže PDF MCP — vlastně MCP pro převod souborů, protože sahá hodně daleko za PDF — je prostě server, který vezme soubor v jednom formátu a vrátí ho v jiném. PDF do Wordu. Složku obrázků do jednoho PDF. Naskenovanou stránku do prohledávatelného textu. Agent se ptá; GuruPDF převádí.
Pod kapotou je to tentýž engine, který pohání gurupdf.com: 126 nástrojů, přes 100 formátů, teď dosažitelných přímo z tvého editoru.
Nastavení zvládneš asi za dvě minuty
Potřebuješ dvě věci: Node (kvůli npx) a bezplatný GuruPDF API klíč. Klíč si vyzvedni na gurupdf.com/profile — bezplatné účty dostávají denní kredity, takže můžeš začít převádět hned.
Server se sám nainstaluje a spustí přes npx; není co klonovat:
npx gurupdf-mcpRučně to ale spouštět nebudeš — místo toho na něj nasměruješ svého MCP klienta. Pro Cursor, Claude Desktop, VS Code nebo Windsurf vlož tohle do své MCP konfigurace:
{
"mcpServers": {
"gurupdf": {
"command": "npx",
"args": ["-y", "gurupdf-mcp"],
"env": { "GURUPDF_API_KEY": "your-token-here" }
}
}
}Restartuj klienta a tvůj agent tiše získá čtyři nástroje: převést soubor, zkontrolovat úlohu, vypsat, co je podporováno, a zkontrolovat zůstatek kreditů. A to je celé nastavení.
Co s tím vlastně můžeš dělat
Tohle je ta zábavná část. Jakmile je to propojené, tyhle prompty fungují úplně samy:
- "Převeď ~/Downloads/invoice.pdf do Wordu, ať můžu upravit součty." — vedle originálu se objeví editovatelný
.docx. - "Udělej z každého screenshotu v ~/shots jedno PDF." — obrázky sloučené, ve správném pořadí, do jednoho souboru.
- "Tenhle sken je jen obrázek. Udělej OCR a dej mi text." — z pixelů se zpátky vytáhne skutečný text.
- "Zkomprimuj report.pdf, má 40 MB a potřebuju ho poslat e-mailem." — menší soubor, který je pořád čitelný.
- "Udělej PDF z https://example.com/pricing." — živá stránka vyrenderovaná do PDF.
Nikdy si nepamatuješ názvy nástrojů ani formáty. Řekni cíl běžnou řečí a server si sám vybere, který ze 126 nástrojů se hodí, spustí ho a výsledek zapíše na disk. Sloučení, rozdělení, otočení, ochrana heslem, vodoznak, Excel ↔ PDF, HEIC → JPG — to všechno je tam.
Když je něco špatně, dá ti vědět
Většina převodníků selže s nějakým záhadným kódem, tenhle je postavený tak, aby se vysvětlil skrze tvého agenta — protože agent je to, co tu odpověď opravdu čte.
Když ti na bezplatném tarifu dojdou kredity, nedostaneš holé 402. Dostaneš větu, kterou ti tvůj asistent předá: narazil jsi na bezplatný limit (2 převody za minutu, 10 za den), zítra se resetuje, a tady je odkaz, pokud nechceš čekat. Strč nástroji špatný formát nebo soubor, který je moc velký, a řekne ti přesně tohle — slovy, ne číslem chyby. Nikdy nemusíš opouštět konverzaci, abys zjistil, co se stalo.
Ta myšlenka "vysvětli to skrze agenta" je taky důvod, proč si tak pečlivě hrajeme s formulacemi. Chybová hláška, kterou žádný člověk nikdy nečte, musí pořád dávat smysl modelu, který ji předává dál.
Co je pod kapotou
- 126 nástrojů, přes 100 formátů. PDF, Word, Excel, PowerPoint, obrázky, e-knihy, dokonce i video — tentýž engine jako na webu.
- Opravdový bezplatný tarif. Každý účet dostává denní kredity. Pro náročnější použití existují placené plány a balíčky kreditů, a tvůj agent tě na ně nasměruje, až to bude dávat smysl, ne dřív.
- Soubory se nepovalují. Všechno putuje přes HTTPS a do hodiny se maže. MCP zapíše výsledek na tvůj disk; kopie na naší straně je krátce nato pryč.
- Open source. Server je pod licencí MIT, publikovaný na npm a uvedený v oficiálním MCP registru, takže si můžeš každý řádek přečíst, než ho spustíš.
Pořiď si ho
Pokud trávíš den v Claude nebo Cursoru a pořád skáčeš ven na nějaký převodníkový web, tohle ten obkružovací výlet smaže.
- Instalace:
npx gurupdf-mcp - Balíček: npmjs.com/package/gurupdf-mcp
- Registr: hledej "GuruPDF" v oficiálním MCP registru
- API klíč: gurupdf.com/profile
Přidej si ho jednou a zapomeň, že tam je — až do příště, kdy bys kvůli převodu souboru otevíral další kartu v prohlížeči, jenže tvůj agent to místo tebe prostě udělá.