ezpzfile

ezpzfile-mcp

Ferramentas de arquivo para agentes de IA. Leia e converta documentos (DOCX, PDF, HWP, HWPX, EML), edite PDFs, redimensione e limpe imagens, remova fundos, crie códigos QR. Tudo roda na sua máquina e nenhum arquivo é enviado.

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

npm · ezpzfile.com/mcp · Node 22.13 ou mais recente

O que isso 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 estava livre para usar o shell e o Node.

	Sem ferramentas	Com ezpzfile-mcp
Custo	$0,28	$0,13
Tempo real	9:06	0:39
Tarefas concluídas	2 / 4	4 / 4
Chamadas de ferramenta	20	10
Tokens	510.607	184.605

Isso é 53% menos custo e 93% menos tempo. Tokens e custo não são estimativas; eles são os valores por mensagem que as sessões registraram, somados. Medido em 2026-09-12.

A sessão sem ferramentas nunca iniciou duas das tarefas. Ela gastou o tempo procurando e instalando bibliotecas para os dois documentos coreanos. Leia a lacuna como um piso, não um teto: se tivesse sido obrigada a concluir todas as 4, a diferença seria maior.

As ferramentas

Seis delas, não vinte e cinco. As definições das ferramentas ficam no contexto do modelo para cada conversa, então trabalhos relacionados compartilham uma ferramenta e um argumento escolhe entre elas. mcp/README.md tem a lista completa e todos os argumentos.

Ferramenta	O que ela faz
doc_read	Texto de DOCX, PDF, HWP, HWPX e EML, incluindo tabelas
doc_convert	Documentos para PDF, páginas de PDF para imagens, planilhas para CSV ou JSON, formatos coreanos entre si
pdf_edit	Mesclar, extrair, excluir, girar, reordenar, dividir, compactar, proteger, desbloquear
pdf_info	Contagem de páginas, tamanhos de página, criptografia, metadados
image_edit	Redimensionar, compactar, converter, remover EXIF e GPS, recortar o fundo
qr_make	Um link ou algum texto como PNG ou SVG

Estrutura

Caminho	O que é
mcp/	O pacote: servidor, ferramentas, build
src/lib/	Código compartilhado com ezpzfile.com
public/vendor/	O mecanismo HWP e as fontes incorporadas nos PDFs gerados

cd mcp
npm install
npm run build      # writes mcp/dist/index.js and mcp/vendor/
node test/protocol.mjs /path/to/samples

sharp e @napi-rs/canvas são nativos, então são compilados para a sua plataforma na instalação. A remoção de fundo baixa um modelo de 4,4MB e um runtime de 14MB na primeira vez que você pedir um recorte, e depois os armazena em cache em ~/.cache/ezpzfile-mcp. Essa é a única coisa aqui que toca a rede, e ela não envia nada.

Uma nota sobre este repositório

Este é um export somente leitura. A cópia de trabalho vive em um monorepo privado junto com o site, e este repositório é regenerado a partir dele a cada lançamento. Por favor, abra issues em vez de pull requests.

Licenciado sob MIT, veja LICENSE.