Конвертируйте файлы прямо в 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

Подключите один раз и забудьте, что он есть, — до следующего момента, когда вы бы открыли вкладку браузера, чтобы сконвертировать файл, а агент просто сделает это за вас.