Конвертуйте файли в Claude і Cursor за допомогою GuruPDF MCP

Ваш кодинговий агент може зібрати застосунок із нуля, розплутати стектрейс і посперечатися з вами про таби проти пробілів. Але дайте йому PDF і попросіть редагований документ Word — і він зависне. Файли лежать на вашому диску; модель живе в чаті. Між ними немає жодного зв'язку.

Саме через цю прірву ми й зробили GuruPDF MCP — невеликий MCP-сервер, який дає Claude, Cursor та будь-якому іншому MCP-клієнту реальну змогу конвертувати файли. Вкажіть шлях у промпті, скажіть, що вам потрібно, — і за мить сконвертований файл опиняється назад на вашому диску. Жодного екрана завантаження, жодного «скачай, а потім перезавантаж кудись ще». Просто «сконвертуй ~/contracts/lease.pdf у Word».

Що таке MCP для конвертації файлів насправді

MCP — Model Context Protocol — це той роз'єм, який дозволяє AI-агенту користуватися інструментами поза межами власної голови. Сервер надає кілька дій; агент викликає їх, коли цього вимагає ваш промпт. Є MCP-сервери для баз даних, браузерів, GitHub.

А от доброго для файлів не було. Тож PDF MCP — насправді MCP для конвертації файлів, адже він сягає далеко за межі PDF — це просто сервер, який бере файл в одному форматі й повертає інший. PDF у Word. Тека зображень в один PDF. Відскановану сторінку в текст із можливістю пошуку. Агент просить — GuruPDF конвертує.

Під капотом це той самий рушій, що стоїть за gurupdf.com: 126 інструментів, 100+ форматів, тепер доступних просто з вашого редактора.

Налаштування приблизно за дві хвилини

Вам потрібні дві речі: Node (для npx) та безкоштовний API-ключ GuruPDF. Візьміть ключ на gurupdf.com/profile — безкоштовні акаунти отримують щоденні кредити, тож конвертувати можна почати одразу.

Сервер встановлюється й запускається сам через npx; клонувати нічого не треба:

npx gurupdf-mcp

Хоча вручну ви цього запускати не будете — ви просто наводите на нього свій MCP-клієнт. Для Cursor, Claude Desktop, VS Code чи Windsurf додайте оце у свій MCP-конфіг:

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

Перезапустіть клієнт — і ваш агент тихцем отримує чотири інструменти: сконвертувати файл, перевірити завдання, переглянути, що підтримується, і дізнатися баланс кредитів. Оце й усе налаштування.

Що з ним реально можна робити

Оце найцікавіше. Щойно все під'єднано, ось реальні промпти, які просто працюють:

• «Сконвертуй ~/Downloads/invoice.pdf у Word, щоб я міг відредагувати суми». — поруч з оригіналом з'являється редагований .docx.
• «Зроби з усіх скриншотів у ~/shots один PDF». — зображення об'єднані по порядку в один файл.
• «Цей скан — просто зображення. Зроби OCR і дай мені текст». — справжній текст, витягнутий назад із пікселів.
• «Стисни report.pdf, він на 40 МБ, а мені треба надіслати його поштою». — менший файл, який усе ще читабельний.
• «Зроби PDF зі сторінки https://example.com/pricing». — жива сторінка, відрендерена в PDF.

Вам не доводиться запам'ятовувати назви інструментів чи форматів. Опишіть мету звичайною мовою — і сервер сам обере, який зі 126 інструментів підходить, запустить його й запише результат на диск. Об'єднати, розділити, повернути, поставити пароль, додати водяний знак, Excel ↔ PDF, HEIC → JPG — усе це там є.

Він відповідає, коли щось не так

Більшість конвертерів падають із загадковим кодом, а цей створений так, щоб пояснювати себе через вашого агента — бо саме агент і є тим, хто насправді читає відповідь.

Вичерпаєте безкоштовний ліміт — і ви не отримаєте голий 402. Ви отримаєте речення, яке передасть ваш асистент: ви досягли безкоштовного ліміту (2 конвертації за хвилину, 10 на день), він скидається завтра, а ось посилання, якщо чекати не хочеться. Передасте інструменту не той формат чи завеликий файл — і він скаже вам саме про це словами, а не номером помилки. Вам жодного разу не доведеться виходити з розмови, щоб зрозуміти, що сталося.

Саме ідея «пояснювати через агента» — ще й причина, чому ми так морочимося над формулюваннями. Повідомлення про помилку, яке людина ніколи не прочитає, усе одно має бути зрозумілим для моделі, що його переказує.

Що під капотом

• 126 інструментів, 100+ форматів. PDF, Word, Excel, PowerPoint, зображення, електронні книги, навіть відео — той самий рушій, що й на сайті.
• Справжній безкоштовний тариф. Кожен акаунт отримує щоденні кредити. Для важчого навантаження є платні плани й пакети кредитів, і ваш агент підкаже вам про них, коли це справді матиме сенс, а не раніше.
• Файли не залежуються. Усе передається через HTTPS і видаляється протягом години. MCP записує результат на ваш диск; копія на нашому боці зникає невдовзі по тому.
• Відкритий код. Сервер має ліцензію MIT, опублікований на npm і внесений до офіційного реєстру MCP, тож ви можете прочитати кожен рядок, перш ніж запускати.

Спробуйте

Якщо ви цілий день у Claude чи Cursor і весь час вискакуєте на якийсь сайт-конвертер, це прибирає зайвий гак.

• Встановлення: npx gurupdf-mcp
• Пакет: npmjs.com/package/gurupdf-mcp
• Реєстр: шукайте «GuruPDF» в офіційному реєстрі MCP
• API-ключ: gurupdf.com/profile

Додайте його раз і забудьте, що він там є — аж до наступного разу, коли ви б відкрили вкладку браузера, щоб сконвертувати файл, а ваш агент просто зробить це замість вас.