ezpzfile MCP
Che il tuo agente smetta di riscrivere lo stesso codice sui file
Un insieme di strumenti per agenti come Claude e Cursor. Modificare un PDF, leggere un documento, cambiare formato, ripulire un’immagine: ognuna diventa una chiamata. Tutto gira sul tuo computer, quindi nessun file viene spedito da nessuna parte.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpDove si innesta
Cosa cambia
Senza
Tre o quattro giri- 1Cercare una libreria decente e installarla.
- 2Scrivere lo script, trovarsi un risultato storto, correggerlo.
- 3Aprire l’uscita solo per vedere se ha funzionato.
Con
Una chiamata- 1Chiamare lo strumento una volta.
- 2Il file finito compare accanto all’originale.
- 3Il controllo del numero di pagine e il conto di quel che non è passato tornano insieme a lui.
Quanto fa risparmiare
Gli stessi quattro file sono stati messi in due sessioni e la stessa frase di incarico è andata allo stesso modello. Un lato poteva usare solo questo server. L’altro non aveva strumenti dedicati e poteva usare liberamente shell e Node.
−53%
di costo in meno
−93%
di tempo in meno
| A mani nude | ezpzfile MCP | |
|---|---|---|
| Costo | $0.28 | $0.13 |
| Tempo impiegato | 9:06 | 0:39 |
| Lavori finiti | 2 / 4 | 4 / 4 |
| Chiamate agli strumenti | 20 | 10 |
| Token consumati | 510,607 | 184,605 |
I quattro incarichi
- 1Unire due PDF e cancellare tre pagine
- 2Ridurre una foto a 1200 di larghezza e cancellarne la posizione
- 3Trasformare un documento HWP in PDF
- 4Tirare fuori il testo da un documento HWP
Il lato a mani nude ne ha finiti solo due su quattro. Sui due documenti coreani ha consumato tutto il tempo a cercare e installare librerie e non ha nemmeno iniziato. Quindi la differenza qui sopra va letta come “almeno tanto”. Se gli fosse stato imposto di finirli tutti e quattro, il divario sarebbe più ampio.
Token e costo non sono stime: sono i numeri reali che ogni sessione ha registrato messaggio per messaggio, sommati. Misurato il 2026-09-12
Trentuno lavori, sei strumenti
Gli strumenti del sito non sono elencati qui uno per uno. La descrizione di ogni strumento occupa il contesto del modello in ogni conversazione, quindi aprirne trentuno si mangerebbe proprio i token che vogliamo risparmiare. I lavori che funzionano allo stesso modo stanno insieme, e un argomento sceglie tra loro.
doc_readEstrae il testo da file DOCX, PDF, HWP, HWPX, EML, JTD e XDW, tabelle e intestazioni comprese. Mostra anche cosa un file registra su di sé, come il luogo di una foto.doc_convertDocumenti in PDF (anche JTD e XDW giapponesi), PDF di nuovo in Word, Excel o HWP, pagine di PDF in JPG o PNG, fogli di calcolo in CSV o JSON, formati coreani fra loro.pdf_editUnisce PDF, li divide, cancella pagine, ruota, riordina, alleggerisce il file, mette o toglie la password, sostituisce il testo sul posto.pdf_infoRestituisce numero di pagine, dimensioni delle pagine e metadati di un PDF.image_editCambia dimensione e peso delle immagini (anche HEIC dell’iPhone), cambia formato, scontorna lo sfondo, cancella posizione e dati della fotocamera.qr_makeTrasforma un link o un testo in un codice QR da stampare e distribuire.
Novità della versione 0.4.0
I sei strumenti ora coprono trentuno lavori del sito, prima erano venticinque. Le novità arrivano come opzioni di strumenti che ci sono già, quindi l’elenco che il vostro agente carica a inizio conversazione è cresciuto appena.
ezpzfile-mcp@0.4.0
PDF di nuovo in Word, Excel e HWP
Paragrafi e tabelle tornano come testo modificabile. Lo strumento riapre ciò che ha scritto per controllarlo ed elenca le pagine che ha dovuto lasciare fuori, come una scansione senza testo.
doc_convert to: docx | xlsx | hwp | hwpxCambiare testo dentro un PDF
Sostituisce una parola o una frase al suo posto, con il carattere del PDF stesso quando ha le lettere giuste. Poi conta quante ne restano, così nessuna sfugge.
pdf_edit op: replace_textIchitaro e DocuWorks
Legge i file giapponesi di Ichitaro (.jtd) e DocuWorks (.xdw, .xbd) senza nessuno dei due programmi e li converte in PDF. Quelli di Ichitaro possono diventare anche Word.
doc_read · doc_convert .jtd .xdw .xbdFoto dell’iPhone (HEIC)
Riduce e converte le foto HEIC e le unisce in un PDF con altre immagini. Escono in JPEG, PNG o WebP.
image_edit .heicQuello che un file dice di sé
Mostra dove e con quale fotocamera è stata scattata una foto, o chi ha scritto un documento e quando. Guardare non cambia nulla. Per cancellarlo da foto e PDF c’è image_edit strip_metadata.
doc_read format: metadataRisposte chiare quando un HWP non si apre
Dice che cosa è davvero il file: un PDF o un Word con il nome sbagliato, un download interrotto o una copia bloccata dalla sicurezza aziendale (DRM). Se il motore va in errore su un file, il successivo passa comunque.
doc_read "Only the name says HWP: this is a PDF."
Quanto ci mette una chiamata
Con il server già avviato, ogni chiamata è stata cronometrata cinque volte e si è annotato il valore di mezzo. Gli ingressi erano un PDF di 15 pagine e 2.2MB, un file HWP di 342KB e un JPEG 3000x2000.
| Chiamata | 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
Dall’avvio del server alla prima risposta
~2,000
Token che l’elenco degli strumenti occupa in ogni conversazione
Installazione
Scegli lo strumento che usi e copia una riga.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpEseguilo una volta in un terminale qualsiasi.
Serve Node 22.13 o più recente. La prima volta scarica il pacchetto, poi parte dalla cache.
Una volta collegato puoi chiedergli così
- “Unisci chapter1.pdf e chapter2.pdf e togli pagina 3”
- “Trasforma ~/Downloads/quote.pdf in un file Word da modificare”
- “Sostituisci ACME con Globex in tutto contract.pdf”
- “Riduci queste foto a 1200 di larghezza e cancella i dati di posizione”
- “Converti ~/Downloads/notice.hwp in PDF”
- Niente codice di conversione da scrivere e correggere per ogni file. Gli strumenti sono già collegati.
- Ogni risultato viene riletto per confermare il numero di pagine, e tutto quello che non è passato viene contato.
- Tutto gira sul tuo computer. Nessun file viene caricato, quindi ci stanno anche i documenti riservati.
Domande frequenti
I file davvero non escono mai dal computer?+
Mai. I motori per i documenti e i caratteri viaggiano dentro il pacchetto, quindi lettura e conversione funzionano senza internet. L’unico scaricamento avviene la prima volta che togliete lo sfondo a una foto: il modello che lo riconosce (circa 18 MB) arriva una volta da ezpzfile.com e resta sul disco. La foto non viene mandata da nessuna parte. Il repository è pubblico e potete controllare di persona.
Ha un costo?+
No. Licenza MIT, pubblicato su npm. Niente account e niente chiave.
Funziona in ChatGPT o Grok?+
Non ancora. Quei due accettano solo server MCP remoti a cui ci si collega tramite indirizzo. Questo gira di proposito sul vostro computer perché i file non ne escano. In Claude, Cursor, VS Code e Gemini CLI funziona già oggi.
Serve la suite per ufficio coreana per gli HWP?+
Non serve, e nemmeno Windows. Il motore che legge e disegna i documenti coreani arriva nel pacchetto, quindi si comporta allo stesso modo su macOS e su Linux.
Perché solo sei strumenti?+
La descrizione di ogni strumento entra nel contesto del modello all’inizio di ogni conversazione. Fare di ciascuno dei trentuno lavori uno strumento a sé farebbe mangiare a quell’elenco proprio i token che vogliamo risparmiare. Perciò i lavori che funzionano allo stesso modo stanno insieme e un argomento sceglie fra loro. Le capacità crescono, gli strumenti no.
Come faccio a sapere che il risultato è venuto bene?+
Lo strumento controlla e lo dice. Rilegge il file appena scritto per confrontare il numero di pagine e conta i caratteri che il font non aveva. L’idea è che un risultato rotto in silenzio esca come un numero invece che come una sorpresa più avanti.
Una riga ed è collegato
Incollatela in un terminale e affidate un file al vostro agente. Se volete toglierlo, cancellate una riga dalla configurazione.
claude mcp add ezpzfile -- npx -y ezpzfile-mcp