ezpzfile MCP

Niech agent przestanie pisać ten sam kod do plików

Zestaw narzędzi dla agentów takich jak Claude i Cursor. Poprawić PDF, przeczytać dokument, zmienić format, uporządkować obraz: każda z tych rzeczy to jedno wywołanie. Wszystko działa na twoim komputerze, więc żaden plik nigdzie nie jedzie.

claude mcp add ezpzfile -- npx -y ezpzfile-mcp

Instalacja Repozytorium i sposób użycia

Gdzie się podpina

Co się zmienia

Bez tego

Trzy, cztery rundy

1Znaleźć sensowną bibliotekę i ją zainstalować.
2Napisać skrypt, natrafić na krzywy wynik, poprawić.
3Otworzyć wynik tylko po to, żeby zobaczyć, czy wyszło.

Z tym

Jedno wywołanie

1Wywołać narzędzie raz.
2Gotowy plik pojawia się obok oryginału.
3Razem z nim wraca sprawdzenie liczby stron i licznik tego, czego nie dało się przenieść.

Ile to oszczędza

Te same cztery pliki trafiły do dwóch sesji, a to samo zdanie z zadaniem dostał ten sam model. Jedna strona mogła używać wyłącznie tego serwera. Druga nie miała dedykowanych narzędzi i mogła dowolnie korzystać z powłoki i Node.

−53%

mniejszy koszt

Bez narzędzi$0.28

ezpzfile MCP$0.13

−93%

mniej czasu

Bez narzędzi9:06

ezpzfile MCP0:39

	Bez narzędzi	ezpzfile MCP
Koszt	$0.28	$0.13
Zużyty czas	9:06	0:39
Skończone zadania	2 / 4	4 / 4
Wywołania narzędzi	20	10
Zużyte tokeny	510,607	184,605

Cztery zadania

1Sklejenie dwóch PDF i usunięcie trzech stron
2Zmniejszenie zdjęcia do szerokości 1200 i usunięcie danych lokalizacji
3Zamiana dokumentu HWP na PDF
4Wyciągnięcie tekstu z dokumentu HWP

Strona bez narzędzi skończyła tylko dwa z czterech zadań. Przy dwóch koreańskich dokumentach cały czas poszedł na szukanie i instalowanie bibliotek, do pracy nigdy nie doszło. Różnicę powyżej trzeba więc czytać jako „co najmniej tyle”. Gdyby kazano jej dokończyć wszystkie cztery, przepaść byłaby większa.

Tokeny i koszt to nie szacunki, tylko prawdziwe liczby, które każda sesja zapisywała przy każdej wiadomości, zsumowane. Zmierzono 2026-09-12

Trzydzieści jeden zadań, sześć narzędzi

Narzędzia z witryny nie są tu wypisane po kolei. Opis każdego narzędzia siedzi w kontekście modelu w każdej rozmowie, więc rozłożenie trzydziestu jeden zjadłoby dokładnie te tokeny, które chcemy zaoszczędzić. Zadania działające tak samo są zgrupowane, a argument wybiera między nimi.

doc_readWyciąga tekst z plików DOCX, PDF, HWP, HWPX, EML, JTD i XDW, razem z tabelami i nagłówkami. Pokazuje też, co plik zapisuje o sobie, na przykład gdzie zrobiono zdjęcie.
doc_convertDokumenty na PDF (także japońskie JTD i XDW), PDF z powrotem na Word, Excel albo HWP, strony PDF na JPG albo PNG, arkusze na CSV albo JSON, formaty koreańskie między sobą.
pdf_editSkleja PDF, dzieli, usuwa strony, obraca, zmienia kolejność, zmniejsza rozmiar, zakłada albo zdejmuje hasło, podmienia tekst w miejscu.
pdf_infoZwraca liczbę stron, rozmiary stron i metadane pliku PDF.
image_editZmienia rozmiar i wagę obrazów (także HEIC z iPhone’a), zmienia format, wycina tło, usuwa dane lokalizacji i aparatu.
qr_makeZamienia odnośnik albo tekst w kod QR, który można wydrukować i rozdać.

Co nowego w 0.4.0

Sześć narzędzi obejmuje teraz trzydzieści jeden zadań witryny, wcześniej dwadzieścia pięć. Nowości przychodzą jako opcje narzędzi, które już są, więc lista, którą agent wczytuje na początku każdej rozmowy, prawie nie urosła.

2 października 2026ezpzfile-mcp@0.4.0

PDF z powrotem do Worda, Excela i HWP
Akapity i tabele wracają jako tekst do edycji. Narzędzie samo otwiera zapisany plik, żeby go sprawdzić, i wypisuje strony, które musiało pominąć, na przykład skan bez tekstu.
doc_convert to: docx | xlsx | hwp | hwpx
Zamiana tekstu w PDF
Podmienia słowo lub frazę w miejscu, czcionką samego PDF-a, jeśli ma ona potrzebne litery. Potem liczy, ile zostało, żeby nic nie umknęło.
pdf_edit op: replace_text
Ichitaro i DocuWorks
Czyta japońskie pliki Ichitaro (.jtd) i DocuWorks (.xdw, .xbd) bez żadnego z tych programów i zamienia je na PDF. Pliki Ichitaro mogą też stać się plikami Worda.
doc_read · doc_convert .jtd .xdw .xbd
Zdjęcia z iPhone’a (HEIC)
Zmniejsza i konwertuje zdjęcia HEIC oraz łączy je w PDF z innymi obrazami. Wychodzą jako JPEG, PNG albo WebP.
image_edit .heic
Co plik mówi o sobie
Pokazuje, gdzie i jakim aparatem zrobiono zdjęcie albo kto i kiedy napisał dokument. Samo oglądanie niczego nie zmienia. Ze zdjęć i PDF-ów usuwa to image_edit strip_metadata.
doc_read format: metadata
Jasna odpowiedź, gdy HWP się nie otwiera
Mówi, czym plik jest naprawdę: PDF-em albo Wordem pod złą nazwą, urwanym pobieraniem czy kopią zablokowaną przez firmowe zabezpieczenia (DRM). Gdy silnik wyłoży się na jednym pliku, następny i tak przejdzie.
doc_read "Only the name says HWP: this is a PDF."

Wszystkie nowości (po angielsku)

Ile trwa jedno wywołanie

Przy uruchomionym serwerze każde wywołanie mierzono pięć razy i zapisano wartość środkową. Na wejściu były PDF na 15 stron o rozmiarze 2.2MB, plik HWP 342KB i JPEG 3000x2000.

Wywołanie	Mediana
`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

Od startu serwera do pierwszej odpowiedzi

~2,000

Tokeny, które lista narzędzi zajmuje w każdej rozmowie

Instalacja

Wybierz narzędzie, którego używasz, i skopiuj jedną linijkę.

claude mcp add ezpzfile -- npx -y ezpzfile-mcp

Uruchom raz w dowolnym terminalu.

Potrzebny Node 22.13 albo nowszy. Za pierwszym razem paczka się pobiera, potem startuje z pamięci podręcznej.

Po podpięciu można prosić tak

“Sklej chapter1.pdf i chapter2.pdf, a stronę 3 wyrzuć”
“Zrób z ~/Downloads/quote.pdf plik Worda, który da się edytować”
“Zamień w contract.pdf wszystkie ACME na Globex”
“Zmniejsz te zdjęcia do 1200 szerokości i usuń dane lokalizacji”
“Przerób ~/Downloads/notice.hwp na PDF”

Żadnego kodu konwersji do pisania i poprawiania przy każdym pliku. Potrzebne narzędzia już są podpięte.
Każdy wynik jest odczytywany z powrotem, żeby potwierdzić liczbę stron, a wszystko, czego nie dało się przenieść, jest policzone.
Wszystko działa na twoim komputerze. Żaden plik nie jest wysyłany, więc mogą tu trafić nawet dokumenty poufne.

Częste pytania

Czy pliki naprawdę nie opuszczają komputera?+

Nie opuszczają. Silniki do dokumentów i kroje pisma jadą wewnątrz paczki, więc czytanie i konwersja działają bez internetu. Pobieranie zdarza się tylko raz, przy pierwszym usuwaniu tła ze zdjęcia: model do wycinania (około 18 MB) ściąga się jeden raz z ezpzfile.com i zostaje na dysku. Samo zdjęcie nigdzie nie jest wysyłane. Repozytorium jest otwarte, można sprawdzić samemu.

Czy to kosztuje?+

Nie. Licencja MIT, opublikowane na npm. Bez konta i bez klucza.

Czy działa w ChatGPT albo Groku?+

Jeszcze nie. Te dwa przyjmują tylko zdalne serwery MCP, do których łączy się po adresie. Ten celowo działa na twoim komputerze, żeby pliki go nie opuszczały. W Claude, Cursorze, VS Code i Gemini CLI działa już dziś.

Czy do HWP potrzebny jest koreański pakiet biurowy?+

Nie jest, ani Windows. Silnik, który czyta i rysuje koreańskie dokumenty, jest w paczce, więc zachowuje się tak samo na macOS i na Linuksie.

Dlaczego tylko sześć narzędzi?+

Opis każdego narzędzia trafia do kontekstu modelu na początku każdej rozmowy. Zrobienie z każdego z trzydziestu jeden zadań osobnego narzędzia sprawiłoby, że ta lista zjadłaby dokładnie te tokeny, które chcemy oszczędzić. Dlatego zadania działające tak samo stoją razem, a wybiera między nimi argument. Możliwości rosną, narzędzia nie.

Skąd mam wiedzieć, że wynik wyszedł dobrze?+

Narzędzie sprawdza i mówi. Odczytuje z powrotem dopiero co zapisany plik, żeby porównać liczbę stron, i liczy znaki, których krój pisma nie miał. Chodzi o to, żeby po cichu zepsuty wynik wyszedł jako liczba, a nie jako niespodzianka później.

Jedna linijka i podpięte

Wklej do terminala i podrzuć agentowi plik. Gdy zechcesz się go pozbyć, usuń jedną linijkę z konfiguracji.

claude mcp add ezpzfile -- npx -y ezpzfile-mcp

Repozytorium i sposób użycia