ezpzfile MCP
Pare o seu agente de reescrever o mesmo código de arquivo
Um conjunto de ferramentas para agentes como Claude e Cursor. Editar um PDF, ler um documento, mudar de formato, tratar uma imagem: cada uma vira uma chamada. Tudo roda no seu computador, então nenhum arquivo é enviado para lugar nenhum.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpOnde funciona
O que muda
Sem isso
Três ou quatro idas e voltas- 1Procurar uma biblioteca que sirva e instalar.
- 2Escrever o script, esbarrar em um resultado torto e corrigir.
- 3Abrir a saída só para ver se funcionou.
Com isso
Uma chamada- 1Chamar a ferramenta uma vez.
- 2O arquivo pronto aparece ao lado do original.
- 3A conferência do número de páginas e a contagem do que não foi levado voltam junto.
Quanto economiza
Os mesmos quatro arquivos foram colocados em duas sessões e a mesma frase de tarefa foi entregue ao mesmo modelo. Um lado só podia usar este servidor. O outro não tinha ferramentas dedicadas e podia usar o terminal e o Node à vontade.
−53%
menos custo
−93%
menos tempo
| No braço | ezpzfile MCP | |
|---|---|---|
| Custo | $0.28 | $0.13 |
| Tempo gasto | 9:06 | 0:39 |
| Tarefas concluídas | 2 / 4 | 4 / 4 |
| Chamadas de ferramenta | 20 | 10 |
| Tokens gastos | 510,607 | 184,605 |
As quatro tarefas
- 1Juntar dois PDFs e apagar três páginas
- 2Reduzir uma foto para 1200 de largura e apagar a localização
- 3Transformar um documento HWP em PDF
- 4Tirar o texto de um documento HWP
O lado no braço terminou só duas das quatro. Nos dois documentos coreanos gastou todo o tempo procurando e instalando bibliotecas e nem chegou a começar. Então a diferença acima deve ser lida como “pelo menos isso”. Se tivesse sido obrigado a terminar as quatro, a distância seria maior.
Os tokens e o custo não são estimativas: são os números reais que cada sessão registrou mensagem a mensagem, somados. Medido em 2026-09-12
Trinta e uma tarefas, seis ferramentas
As ferramentas do site não estão listadas aqui uma a uma. A descrição de cada ferramenta ocupa o contexto do modelo em toda conversa, então abrir trinta e uma delas comeria justamente os tokens que queremos poupar. Tarefas que funcionam do mesmo jeito ficam agrupadas, e um argumento escolhe entre elas.
doc_readTira o texto de arquivos DOCX, PDF, HWP, HWPX, EML, JTD e XDW, tabelas e cabeçalhos incluídos. Também mostra o que um arquivo guarda sobre si, como onde uma foto foi tirada.doc_convertDocumentos para PDF (inclusive JTD e XDW japoneses), PDF de volta para Word, Excel ou HWP, páginas de PDF para JPG ou PNG, planilhas para CSV ou JSON, formatos coreanos entre si.pdf_editJunta PDFs, separa, apaga páginas, gira, reordena, reduz o tamanho, põe ou tira a senha e troca texto no lugar.pdf_infoDevolve o número de páginas, os tamanhos de página e os metadados de um PDF.image_editMuda o tamanho e o peso das imagens (inclusive HEIC do iPhone), o formato, recorta o fundo, apaga localização e dados da câmera.qr_makeTransforma um link ou um texto em um QR Code que dá para imprimir e distribuir.
Novidades da versão 0.4.0
As seis ferramentas agora cobrem trinta e uma tarefas do site, antes eram vinte e cinco. O que é novo entra como opção de ferramentas que já existem, então a lista que seu agente carrega no início de cada conversa quase não cresceu.
ezpzfile-mcp@0.4.0
PDF de volta para Word, Excel e HWP
Parágrafos e tabelas voltam como texto editável. A ferramenta reabre o que escreveu para conferir e lista as páginas que precisou deixar de fora, como um escaneamento sem texto.
doc_convert to: docx | xlsx | hwp | hwpxTrocar texto dentro de um PDF
Substitui uma palavra ou frase no lugar, com a fonte do próprio PDF quando ela tem as letras. Depois conta quantas sobraram, para nenhuma passar despercebida.
pdf_edit op: replace_textIchitaro e DocuWorks
Lê arquivos japoneses do Ichitaro (.jtd) e do DocuWorks (.xdw, .xbd) sem nenhum dos dois programas e os converte em PDF. Os do Ichitaro também podem virar Word.
doc_read · doc_convert .jtd .xdw .xbdFotos do iPhone (HEIC)
Reduz e converte fotos HEIC e junta tudo num PDF com outras imagens. Elas saem em JPEG, PNG ou WebP.
image_edit .heicO que um arquivo conta sobre si
Mostra onde e com que câmera uma foto foi tirada, ou quem escreveu um documento e quando. Olhar não muda nada. Para apagar isso de fotos e PDFs, use image_edit strip_metadata.
doc_read format: metadataRespostas claras quando um HWP não abre
Diz o que o arquivo realmente é: um PDF ou Word com o nome trocado, um download que parou no meio ou uma cópia travada pela segurança de uma empresa (DRM). Se o motor falhar num arquivo, o próximo segue normalmente.
doc_read "Only the name says HWP: this is a PDF."
Quanto demora uma chamada
Com o servidor já no ar, cada chamada foi cronometrada cinco vezes e o valor do meio foi anotado. As entradas foram um PDF de 15 páginas e 2.2MB, um arquivo HWP de 342KB e um JPEG de 3000x2000.
| Chamada | 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
Do servidor subir até a primeira resposta
~2,000
Tokens que a lista de ferramentas ocupa em cada conversa
Instalação
Escolha a ferramenta que você usa e copie uma linha.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpRode uma vez em qualquer terminal.
Precisa de Node 22.13 ou mais novo. Na primeira vez o pacote é baixado, depois ele sobe do cache.
Depois de conectado, dá para pedir assim
- “Junte chapter1.pdf e chapter2.pdf e tire a página 3”
- “Transforme ~/Downloads/quote.pdf num arquivo Word que eu possa editar”
- “Troque ACME por Globex em todo o contract.pdf”
- “Reduza estas fotos para 1200 de largura e apague os dados de localização”
- “Converta ~/Downloads/notice.hwp para PDF”
- Nada de escrever e corrigir código de conversão para cada arquivo. As ferramentas já estão conectadas.
- Cada resultado é relido para conferir o número de páginas, e tudo o que não pôde ser levado é contado.
- Tudo roda no seu computador. Nenhum arquivo é enviado, então até documentos sigilosos cabem aqui.
Perguntas frequentes
Os arquivos realmente não saem do computador?+
Não saem. Os motores de documentos e as fontes vão dentro do pacote, então ler e converter funciona sem internet. O único download acontece na primeira vez que você tira o fundo de uma foto: o modelo de recorte (cerca de 18 MB) é baixado uma vez de ezpzfile.com e fica no disco. A foto não é enviada a lugar nenhum. O repositório é público e você pode conferir por conta própria.
Tem algum custo?+
Não. Licença MIT, publicado no npm. Sem conta e sem chave.
Funciona no ChatGPT ou no Grok?+
Ainda não. Esses dois só aceitam servidores MCP remotos aos quais se conectam por endereço. Este roda de propósito na sua máquina para que os arquivos não saiam dela. No Claude, Cursor, VS Code e Gemini CLI funciona hoje.
Preciso do pacote de escritório coreano para os HWP?+
Não precisa, e Windows também não. O motor que lê e desenha documentos coreanos vem junto no pacote, então roda igual no macOS e no Linux.
Por que só seis ferramentas?+
A descrição de cada ferramenta entra no contexto do modelo no início de toda conversa. Transformar cada uma das trinta e uma tarefas numa ferramenta própria faria essa lista comer justamente os tokens que queremos poupar. Por isso tarefas que funcionam do mesmo jeito ficam agrupadas e um argumento escolhe entre elas. As capacidades crescem, as ferramentas não.
Como sei que o resultado saiu certo?+
A ferramenta confere e avisa. Ela relê o arquivo que acabou de escrever para comparar a contagem de páginas e conta os caracteres que a fonte não tinha. A ideia é que um resultado quebrado em silêncio apareça como um número em vez de como surpresa mais tarde.
Uma linha e está conectado
Cole no terminal e entregue um arquivo ao seu agente. Se quiser tirar, apague uma linha da configuração.
claude mcp add ezpzfile -- npx -y ezpzfile-mcp