ezpzfile MCP
Пусть агент перестанет переписывать один и тот же код
Набор инструментов для агентов вроде Claude и Cursor. Отредактировать PDF, прочитать документ, сменить формат, обработать картинку: каждая такая задача умещается в один вызов. Всё работает на вашем компьютере, поэтому файлы никуда не отправляются.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpГде это работает
Что меняется
Без него
Три-четыре круга- 1Найти подходящую библиотеку и поставить её.
- 2Написать скрипт, наткнуться на кривой результат, починить.
- 3Открыть результат просто чтобы посмотреть, получилось ли.
С ним
Один вызов- 1Вызвать инструмент один раз.
- 2Готовый файл появляется рядом с исходным.
- 3Вместе с ним возвращается сверка числа страниц и счёт всего, что не удалось перенести.
Сколько это экономит
Одни и те же четыре файла положили в две сессии и дали одной и той же модели одну и ту же формулировку задания. Одной стороне разрешили только этот сервер. У другой не было никаких специальных инструментов, зато были шелл и Node без ограничений.
−53%
меньше стоимость
−93%
меньше времени
| Без инструментов | ezpzfile MCP | |
|---|---|---|
| Стоимость | $0.28 | $0.13 |
| Затраченное время | 9:06 | 0:39 |
| Сделано задач | 2 / 4 | 4 / 4 |
| Вызовов инструментов | 20 | 10 |
| Израсходовано токенов | 510,607 | 184,605 |
Четыре задания
- 1Склеить два PDF и удалить три страницы
- 2Уменьшить фото до ширины 1200 и стереть геоданные
- 3Превратить документ HWP в PDF
- 4Вытащить текст из документа HWP
Сторона без инструментов довела до конца только две задачи из четырёх. На двух корейских документах всё время ушло на поиск и установку библиотек, до самой работы дело так и не дошло. Поэтому разницу выше нужно читать как «как минимум столько». Если бы её заставили закончить все четыре, разрыв оказался бы больше.
Токены и стоимость не оценка, а реальные цифры, которые сессия записывала на каждое сообщение, сложенные вместе. Дата измерения: 2026-09-12
Тридцать одна задача, шесть инструментов
Инструменты сайта не перечислены здесь по одному. Описания инструментов лежат в контексте модели в каждом разговоре, так что тридцать одна штука съела бы те самые токены, которые мы бережём. Задачи, устроенные одинаково, собраны вместе, а нужную выбирает аргумент.
doc_readДостаёт текст из файлов DOCX, PDF, HWP, HWPX, EML, JTD и XDW, включая таблицы и колонтитулы. Показывает и то, что файл хранит о себе, например где сделано фото.doc_convertДокументы в PDF (и японские JTD и XDW), PDF обратно в Word, Excel или HWP, страницы PDF в JPG или PNG, таблицы в CSV или JSON, корейские форматы друг в друга.pdf_editСклеивает PDF, режет, удаляет страницы, поворачивает, меняет порядок, ужимает файл, ставит и снимает пароль, заменяет текст на месте.pdf_infoВозвращает число страниц, размеры страниц и сведения о PDF-документе.image_editМеняет размер и вес изображений (и HEIC с iPhone), формат, вырезает фон, стирает геоданные и сведения о камере.qr_makeПревращает ссылку или текст в QR-код, который можно распечатать и раздать.
Что нового в 0.4.0
Шесть инструментов теперь берут на себя тридцать одну задачу сайта, а было двадцать пять. Новое приходит как параметры уже знакомых инструментов, поэтому список, который агент загружает в начале каждого разговора, почти не вырос.
ezpzfile-mcp@0.4.0
PDF обратно в Word, Excel и HWP
Абзацы и таблицы возвращаются редактируемым текстом. Инструмент сам открывает записанный файл, чтобы его проверить, и перечисляет страницы, которые пришлось пропустить, например скан без текста.
doc_convert to: docx | xlsx | hwp | hwpxЗамена текста в PDF
Меняет слово или фразу прямо на месте, шрифтом самого PDF, если в нём есть нужные буквы. Потом считает, сколько осталось, чтобы ни одно место не потерялось.
pdf_edit op: replace_textIchitaro и DocuWorks
Читает японские файлы Ichitaro (.jtd) и DocuWorks (.xdw, .xbd) без этих программ и переводит их в PDF. Файлы Ichitaro можно перевести и в Word.
doc_read · doc_convert .jtd .xdw .xbdФото с iPhone (HEIC)
Уменьшает и конвертирует фото HEIC и собирает их в PDF вместе с другими картинками. На выходе JPEG, PNG или WebP.
image_edit .heicЧто файл говорит о себе
Показывает, где и на какую камеру снято фото, кто и когда написал документ. Просмотр ничего не меняет. Стереть это из фото и PDF можно через image_edit strip_metadata.
doc_read format: metadataПонятный ответ, когда HWP не открывается
Говорит, что это за файл на самом деле: PDF или Word с чужим именем, оборванная загрузка или копия, закрытая корпоративной защитой (DRM). Если движок упал на одном файле, следующий всё равно обработается.
doc_read "Only the name says HWP: this is a PDF."
Насколько быстрый один вызов
Сервер держали запущенным, каждый вызов замеряли пять раз и записывали среднее значение. На вход шли PDF на 15 страниц размером 2.2MB, файл HWP на 342KB и JPEG 3000x2000.
| Вызов | Медиана |
|---|---|
image_edit · strip_metadata | 1ms |
qr_make | 4ms |
image_edit · resize | 16ms |
doc_read · pdf | 117ms |
pdf_info | 157ms |
doc_read · hwp | 342ms |
pdf_edit · merge | 657ms |
doc_convert · pdf→jpg | 803ms |
pdf_edit · compress | 1,168ms |
doc_convert · hwp→pdf | 1,541ms |
pdf_edit · protect | 2,821ms |
360ms
От запуска сервера до первого ответа
~2,000
Токены, которые список инструментов занимает в каждом разговоре
Установка
Выберите свой инструмент и скопируйте одну строку.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpВыполните один раз в любом терминале.
Нужен Node 22.13 или новее. Первый запуск скачивает пакет, дальше он стартует из кеша.
Подключили, теперь можно просить так
- “Склей chapter1.pdf и chapter2.pdf, а третью страницу выкинь”
- “Сделай из ~/Downloads/quote.pdf файл Word, который можно править”
- “Замени в contract.pdf все ACME на Globex”
- “Уменьши эти фото до 1200 по ширине и убери геоданные”
- “Переведи ~/Downloads/notice.hwp в PDF”
- Не надо писать и чинить код конвертации под каждый файл. Нужные инструменты уже подключены.
- Готовый файл перечитывается для сверки числа страниц, а всё, что не удалось перенести, пересчитывается.
- Всё работает на вашем компьютере. Ни один файл не загружается, так что доверить можно и служебные документы.
Частые вопросы
Файлы правда никуда не уходят?+
Правда. Движки для документов и шрифты лежат внутри пакета, так что чтение и преобразование работают без интернета. Скачивание бывает только одно, при первом удалении фона с фото: модель для вырезания (около 18 МБ) один раз загружается с ezpzfile.com и остаётся на диске. Само фото никуда не отправляется. Репозиторий открыт, проверить можно самому.
Это платно?+
Нет. Лицензия MIT, опубликовано в npm. Ни аккаунта, ни ключа не нужно.
Работает ли в ChatGPT или Grok?+
Пока нет. Эти двое принимают только удалённые MCP-серверы, к которым подключаются по адресу. Наш намеренно работает на вашем компьютере, чтобы файлы его не покидали. В Claude, Cursor, VS Code и Gemini CLI всё работает уже сегодня.
Нужен ли корейский офисный пакет для HWP?+
Не нужен, и Windows тоже. Движок, который читает и рисует корейские документы, поставляется вместе с пакетом и одинаково работает на macOS и Linux.
Почему инструментов всего шесть?+
Описания инструментов попадают в контекст модели в начале каждого разговора. Если сделать из каждой из тридцати одной задачи отдельный инструмент, этот список съест ровно те токены, которые мы бережём. Поэтому задачи, устроенные одинаково, собраны вместе, а нужную выбирает аргумент. Возможности прибавляются, инструменты нет.
Как понять, что результат верный?+
Инструмент проверяет сам и сообщает. Он перечитывает только что записанный файл и сверяет число страниц, а также считает символы, которых не оказалось в шрифте. Смысл в том, чтобы тихо испортившийся результат выходил наружу цифрой, а не неожиданностью потом.
Одна строка, и он подключён
Вставьте в терминал и отдайте агенту файл. Если передумаете, уберите одну строку из настроек.
claude mcp add ezpzfile -- npx -y ezpzfile-mcp