ezpzfile MCP
Que tu agente deje de reescribir el mismo código de archivos
Un conjunto de herramientas para agentes como Claude y Cursor. Editar un PDF, leer un documento, cambiar de formato, limpiar una imagen: cada una se convierte en una llamada. Todo corre en tu equipo, así que ningún archivo se envía a ninguna parte.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpDónde funciona
Qué cambia
Sin esto
Tres o cuatro vueltas- 1Buscar una biblioteca que sirva e instalarla.
- 2Escribir el script, encontrarse con un resultado torcido y arreglarlo.
- 3Abrir la salida solo para ver si funcionó.
Con esto
Una llamada- 1Llamar a la herramienta una vez.
- 2El archivo resultante queda junto al original.
- 3La comprobación del número de páginas y la cuenta de lo que no se pudo trasladar vuelven con él.
Cuánto ahorra
Se pusieron los mismos cuatro archivos en dos sesiones y se le dio la misma frase de encargo al mismo modelo. Un lado solo podía usar este servidor. El otro no tenía herramientas dedicadas y podía usar la terminal y Node a voluntad.
−53%
menos coste
−93%
menos tiempo
| A pelo | ezpzfile MCP | |
|---|---|---|
| Coste | $0.28 | $0.13 |
| Tiempo empleado | 9:06 | 0:39 |
| Tareas terminadas | 2 / 4 | 4 / 4 |
| Llamadas a herramientas | 20 | 10 |
| Tokens gastados | 510,607 | 184,605 |
Los cuatro encargos
- 1Unir dos PDF y borrar tres páginas
- 2Reducir una foto a 1200 de ancho y borrar su ubicación
- 3Convertir un documento HWP a PDF
- 4Sacar el texto de un documento HWP
El lado a pelo solo terminó dos de las cuatro. En los dos documentos coreanos se le fue el tiempo buscando e instalando bibliotecas y ni siquiera llegó a empezar. Así que la diferencia de arriba hay que leerla como “al menos esto”. Si se le hubiera exigido acabar las cuatro, la distancia sería mayor.
Los tokens y el coste no son estimaciones: son las cifras reales que cada sesión registró mensaje a mensaje, sumadas. Medido el 2026-09-12
Treinta y una tareas, seis herramientas
Las herramientas del sitio no aparecen aquí una por una. La descripción de cada herramienta ocupa contexto del modelo en cada conversación, así que desplegar treinta y una se comería los tokens que queremos ahorrar. Las tareas que funcionan igual se agrupan y un argumento elige entre ellas.
doc_readExtrae el texto de archivos DOCX, PDF, HWP, HWPX, EML, JTD y XDW, con tablas y encabezados incluidos. También muestra lo que un archivo guarda de sí mismo, como dónde se tomó una foto.doc_convertDocumentos a PDF (también JTD y XDW japoneses), PDF de vuelta a Word, Excel o HWP, páginas de PDF a JPG o PNG, hojas de cálculo a CSV o JSON, formatos coreanos entre sí.pdf_editUne PDF, los parte, borra páginas, gira, reordena, reduce el tamaño, pone o quita la contraseña y cambia texto en su sitio.pdf_infoDevuelve el número de páginas, los tamaños de página y los metadatos de un PDF.image_editCambia el tamaño y el peso de las imágenes (también HEIC del iPhone), el formato, recorta el fondo, borra la ubicación y los datos de cámara.qr_makeConvierte un enlace o un texto en un código QR que puedes imprimir y repartir.
Novedades de la versión 0.4.0
Las seis herramientas ya cubren treinta y una tareas del sitio, antes eran veinticinco. Lo nuevo llega como opciones de herramientas que ya existen, así que la lista que su agente carga al empezar cada conversación apenas creció.
ezpzfile-mcp@0.4.0
PDF de vuelta a Word, Excel y HWP
Los párrafos y las tablas vuelven como texto editable. La herramienta abre de nuevo lo que escribió para comprobarlo y enumera las páginas que tuvo que dejar fuera, como un escaneo sin texto.
doc_convert to: docx | xlsx | hwp | hwpxCambiar texto dentro de un PDF
Sustituye una palabra o una frase en su sitio, con la tipografía del propio PDF cuando esta tiene las letras. Después cuenta cuántas quedan, para que no se escape ninguna.
pdf_edit op: replace_textIchitaro y DocuWorks
Lee archivos japoneses de Ichitaro (.jtd) y DocuWorks (.xdw, .xbd) sin ninguno de los dos programas y los convierte en PDF. Los de Ichitaro también pueden pasar a Word.
doc_read · doc_convert .jtd .xdw .xbdFotos del iPhone (HEIC)
Reduce y convierte fotos HEIC, y las une en un PDF con otras imágenes. Salen en JPEG, PNG o WebP.
image_edit .heicLo que un archivo cuenta de sí mismo
Muestra dónde y con qué cámara se tomó una foto, o quién escribió un documento y cuándo. Mirar no cambia nada. Para borrarlo de fotos y PDF está image_edit strip_metadata.
doc_read format: metadataRespuestas claras cuando un HWP no abre
Dice qué es el archivo en realidad: un PDF o un Word con el nombre cambiado, una descarga que se cortó o una copia bloqueada por la seguridad de una empresa (DRM). Si el motor falla con un archivo, el siguiente se procesa igual.
doc_read "Only the name says HWP: this is a PDF."
Cuánto tarda una llamada
Con el servidor ya levantado, cada llamada se cronometró cinco veces y se anotó el valor central. Las entradas fueron un PDF de 15 páginas y 2.2MB, un archivo HWP de 342KB y un JPEG de 3000x2000.
| Llamada | 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
Del arranque del servidor a la primera respuesta
~2,000
Tokens que la lista de herramientas ocupa en cada conversación
Instalación
Elige la herramienta que usas y copia una línea.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpEjecútalo una vez en cualquier terminal.
Hace falta Node 22.13 o más nuevo. La primera vez se descarga el paquete, luego arranca desde la caché.
Una vez conectado, puedes pedirle cosas así
- “Une chapter1.pdf y chapter2.pdf y quita la página 3”
- “Convierte ~/Downloads/quote.pdf en un Word que pueda editar”
- “Cambia ACME por Globex en todo contract.pdf”
- “Reduce estas fotos a 1200 de ancho y borra los datos de ubicación”
- “Convierte ~/Downloads/notice.hwp a PDF”
- Nada de escribir y depurar código de conversión para cada archivo. Las herramientas ya vienen conectadas.
- Cada resultado se vuelve a leer para confirmar el número de páginas, y se cuenta todo lo que no se pudo trasladar.
- Todo corre en tu equipo. No se sube ningún archivo, así que hasta los documentos confidenciales caben aquí.
Preguntas frecuentes
¿De verdad los archivos no salen del equipo?+
No salen. Los motores de documentos y las tipografías viajan dentro del paquete, así que leer y convertir funciona sin internet. Solo hay una descarga, la primera vez que quita el fondo de una foto: el modelo de recorte (unos 18 MB) se baja una vez de ezpzfile.com y se queda en el disco. La foto no se envía a ninguna parte. El repositorio es público y puede comprobarlo usted mismo.
¿Cuesta algo?+
No. Licencia MIT y publicado en npm. Sin cuenta y sin clave.
¿Funciona en ChatGPT o Grok?+
Todavía no. Esos dos solo admiten servidores MCP remotos a los que se conectan por dirección web. Este corre a propósito en su equipo para que los archivos no lo abandonen. En Claude, Cursor, VS Code y Gemini CLI funciona hoy.
¿Hace falta la suite ofimática coreana para los HWP?+
No hace falta, ni Windows tampoco. El motor que lee y dibuja documentos coreanos viene en el paquete, así que se comporta igual en macOS y en Linux.
¿Por qué solo seis herramientas?+
La descripción de cada herramienta entra en el contexto del modelo al empezar cada conversación. Convertir cada una de las treinta y una tareas en una herramienta propia haría que esa lista se comiera justo los tokens que queremos ahorrar. Por eso las tareas que funcionan igual van agrupadas y un argumento elige entre ellas. Aunque crezcan las capacidades, no crecen las herramientas.
¿Cómo sé que el resultado ha salido bien?+
La herramienta lo comprueba y lo dice. Relee el archivo recién escrito para contrastar el número de páginas y cuenta los caracteres que la tipografía no tenía. La idea es que un resultado roto en silencio aparezca como una cifra en vez de como una sorpresa más adelante.
Una línea y queda conectado
Péguelo en una terminal y entréguele un archivo a su agente. Si quiere quitarlo, borre una línea de la configuración.
claude mcp add ezpzfile -- npx -y ezpzfile-mcp