ezpzfile MCP
Ihr Agent soll denselben Dateicode nicht ständig neu schreiben
Ein Satz Werkzeuge für Agenten wie Claude und Cursor. Ein PDF bearbeiten, ein Dokument lesen, ein Format wechseln, ein Bild aufräumen: daraus wird jeweils ein Aufruf. Alles läuft auf Ihrem Rechner, also geht keine Datei irgendwohin.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpWo es sich einhängt
Was sich ändert
Ohne
Drei, vier Runden- 1Eine brauchbare Bibliothek suchen und einrichten.
- 2Das Skript schreiben, auf ein schiefes Ergebnis stoßen, nachbessern.
- 3Die Ausgabe öffnen, nur um zu sehen, ob es geklappt hat.
Mit
Ein Aufruf- 1Das Werkzeug einmal aufrufen.
- 2Die fertige Datei liegt neben dem Original.
- 3Der Abgleich der Seitenzahl und die Zahl dessen, was nicht mitkam, kommen gleich mit zurück.
Wie viel das spart
Dieselben vier Dateien lagen in zwei Sitzungen bereit, und derselbe Auftragssatz ging an dasselbe Modell. Die eine Seite durfte nur diesen Server benutzen. Die andere hatte keine eigenen Werkzeuge und durfte Shell und Node frei verwenden.
−53%
weniger Kosten
−93%
weniger Zeit
| Ohne Werkzeug | ezpzfile MCP | |
|---|---|---|
| Kosten | $0.28 | $0.13 |
| Gebrauchte Zeit | 9:06 | 0:39 |
| Erledigte Aufgaben | 2 / 4 | 4 / 4 |
| Werkzeugaufrufe | 20 | 10 |
| Verbrauchte Token | 510,607 | 184,605 |
Die vier Aufträge
- 1Zwei PDFs zusammenfügen und drei Seiten löschen
- 2Ein Foto auf 1200 Breite bringen und die Ortsdaten löschen
- 3Ein HWP-Dokument in ein PDF umwandeln
- 4Den Text aus einem HWP-Dokument holen
Die Seite ohne Werkzeug wurde nur mit zweien von vieren fertig. Bei den beiden koreanischen Dokumenten ging die ganze Zeit für das Suchen und Einrichten von Bibliotheken drauf, angefangen hat sie damit nie. Der Abstand oben ist deshalb als „mindestens so viel“ zu lesen. Hätte sie alle vier zu Ende bringen müssen, wäre er größer.
Token und Kosten sind keine Schätzung, sondern die echten Zahlen, die jede Sitzung pro Nachricht festgehalten hat, aufaddiert. Gemessen am 2026-09-12
Einunddreißig Aufgaben, sechs Werkzeuge
Die Werkzeuge der Website stehen hier nicht einzeln. Werkzeugbeschreibungen liegen in jedem Gespräch im Kontext des Modells, einunddreißig davon würden genau die Token fressen, die gespart werden sollen. Aufgaben, die gleich funktionieren, stehen zusammen, und ein Argument wählt dazwischen.
doc_readHolt den Text aus DOCX-, PDF-, HWP-, HWPX-, EML-, JTD- und XDW-Dateien, samt Tabellen und Kopfzeilen. Zeigt auch, was eine Datei über sich selbst speichert, etwa wo ein Foto entstand.doc_convertDokumente zu PDF (auch japanische JTD und XDW), PDF zurück zu Word, Excel oder HWP, PDF-Seiten zu JPG oder PNG, Tabellen zu CSV oder JSON, koreanische Formate untereinander.pdf_editFügt PDFs zusammen, teilt sie, löscht Seiten, dreht, sortiert um, drückt die Größe, setzt oder nimmt das Passwort und ersetzt Text an Ort und Stelle.pdf_infoGibt Seitenzahl, Seitengrößen und Metadaten eines PDFs zurück.image_editÄndert Größe und Gewicht von Bildern (auch HEIC vom iPhone), wechselt das Format, stellt frei, löscht Orts- und Kameradaten.qr_makeMacht aus einem Link oder einem Text einen QR-Code zum Ausdrucken und Verteilen.
Neu in 0.4.0
Die sechs Werkzeuge decken jetzt einunddreißig Aufgaben der Website ab, vorher waren es fünfundzwanzig. Neues kommt als Option an Werkzeuge, die es schon gibt. Die Liste, die Ihr Agent zu Beginn jedes Gesprächs lädt, ist darum kaum gewachsen.
ezpzfile-mcp@0.4.0
PDF zurück in Word, Excel und HWP
Absätze und Tabellen kommen als bearbeitbarer Text zurück. Das Werkzeug öffnet seine Ausgabe zur Kontrolle noch einmal und listet Seiten auf, die es auslassen musste, etwa Scans ohne Text.
doc_convert to: docx | xlsx | hwp | hwpxText im PDF ersetzen
Tauscht ein Wort oder eine Wendung an Ort und Stelle aus, in der Schrift des PDFs, sofern sie die nötigen Zeichen hat. Danach zählt es, was übrig ist, damit keine Stelle untergeht.
pdf_edit op: replace_textIchitaro und DocuWorks
Liest japanische Ichitaro-Dateien (.jtd) und DocuWorks-Dateien (.xdw, .xbd) ohne eines der beiden Programme und macht PDFs daraus. Aus Ichitaro-Dateien wird auf Wunsch auch Word.
doc_read · doc_convert .jtd .xdw .xbdiPhone-Fotos (HEIC)
Verkleinert und wandelt HEIC-Fotos und bindet sie mit anderen Bildern zu einem PDF. Heraus kommen JPEG, PNG oder WebP.
image_edit .heicWas eine Datei über sich verrät
Zeigt, wo und mit welcher Kamera ein Foto entstand oder wer ein Dokument wann geschrieben hat. Das Ansehen ändert nichts. Aus Fotos und PDFs löscht es image_edit strip_metadata.
doc_read format: metadataKlare Auskunft, wenn eine HWP nicht aufgeht
Es sagt, was die Datei wirklich ist: ein PDF oder eine Word-Datei mit falschem Namen, ein abgebrochener Download oder eine Kopie, die ein Firmenschutz (DRM) sperrt. Stürzt die Engine bei einer Datei ab, läuft die nächste trotzdem durch.
doc_read "Only the name says HWP: this is a PDF."
Wie lange ein Aufruf dauert
Bei laufendem Server wurde jeder Aufruf fünfmal gestoppt und der mittlere Wert notiert. Eingaben waren ein PDF mit 15 Seiten und 2.2MB, eine HWP-Datei mit 342KB und ein JPEG mit 3000x2000.
| Aufruf | Mittelwert |
|---|---|
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
Vom Start des Servers bis zur ersten Antwort
~2,000
Token, die die Werkzeugliste in jedem Gespräch belegt
Einrichten
Wählen Sie Ihr Werkzeug und kopieren Sie eine Zeile.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpEinmal in einem beliebigen Terminal ausführen.
Node 22.13 oder neuer genügt. Beim ersten Mal wird das Paket geladen, danach startet es aus dem Zwischenspeicher.
Sobald es eingebunden ist, können Sie so fragen
- “Häng chapter1.pdf und chapter2.pdf aneinander und wirf Seite 3 raus”
- “Mach aus ~/Downloads/quote.pdf eine Word-Datei, die ich bearbeiten kann”
- “Ersetz in contract.pdf überall ACME durch Globex”
- “Rechne diese Fotos auf 1200 Breite runter und lösch die Ortsdaten”
- “Wandle ~/Downloads/notice.hwp in ein PDF um”
- Kein Umwandlungscode, der für jede Datei geschrieben und nachgebessert werden muss. Die Werkzeuge hängen schon dran.
- Jedes Ergebnis wird zurückgelesen, um die Seitenzahl zu bestätigen, und alles, was nicht mitkam, wird gezählt.
- Alles läuft auf Ihrem Rechner. Keine Datei wird hochgeladen, also dürfen auch vertrauliche Unterlagen hierher.
Häufige Fragen
Verlassen die Dateien wirklich nie den Rechner?+
Nie. Die Dokumenten-Engines und die Schriften stecken im Paket, Lesen und Umwandeln laufen also ohne Internet. Heruntergeladen wird nur einmal, beim ersten Freistellen eines Fotos: Das Freistellmodell (etwa 18 MB) kommt einmal von ezpzfile.com und bleibt auf der Festplatte. Ihr Foto wird dabei nirgendwohin geschickt. Das Repository ist offen, Sie können es selbst nachsehen.
Kostet das etwas?+
Nein. MIT-Lizenz, veröffentlicht auf npm. Kein Konto, kein Schlüssel.
Läuft es in ChatGPT oder Grok?+
Noch nicht. Die beiden nehmen nur entfernte MCP-Server an, zu denen man sich über eine Adresse verbindet. Dieser läuft absichtlich auf Ihrem Rechner, damit die Dateien ihn nicht verlassen. In Claude, Cursor, VS Code und Gemini CLI geht es heute schon.
Brauche ich für HWP eine koreanische Office-Software?+
Nein, und Windows auch nicht. Die Engine, die koreanische Dokumente liest und zeichnet, kommt mit dem Paket und verhält sich unter macOS und Linux gleich.
Warum nur sechs Werkzeuge?+
Die Beschreibung jedes Werkzeugs landet zu Beginn jedes Gesprächs im Kontext des Modells. Aus jeder der einunddreißig Aufgaben ein eigenes Werkzeug zu machen hieße, dass genau diese Liste die Token frisst, die gespart werden sollen. Aufgaben, die gleich funktionieren, stehen deshalb zusammen, und ein Argument wählt dazwischen. Die Fähigkeiten wachsen, die Werkzeuge nicht.
Woran erkenne ich, dass das Ergebnis stimmt?+
Das Werkzeug prüft es und sagt es. Es liest die eben geschriebene Datei zurück, gleicht die Seitenzahl ab und zählt die Zeichen, für die die Schrift keine Glyphe hatte. So zeigt sich ein still kaputtes Ergebnis als Zahl statt später als Überraschung.
Eine Zeile und es hängt dran
In ein Terminal einfügen und Ihrem Agenten eine Datei geben. Wenn Sie es wieder loswerden wollen, löschen Sie eine Zeile aus der Konfiguration.
claude mcp add ezpzfile -- npx -y ezpzfile-mcp