ezpzfile MCP
别让代理一再重写同样的文件代码
给 Claude、Cursor 这类代理接上的一套工具。编辑 PDF、读取文档、转换格式、处理图片，每一件都只要调用一次。全部在这台电脑里运行，文件不会被送到任何地方。
claude mcp add ezpzfile -- npx -y ezpzfile-mcp能接在哪里
有什么不同
接之前
来回三四次- 1先找一个能用的库装上。
- 2写脚本，碰到结果不对再改。
- 3打开结果用眼睛确认有没有做对。
接之后
调用一次- 1调用一次工具。
- 2结果文件就在原处生成。
- 3页数核对结果和没能搬过去的数量一并返回。
到底省多少
把同样的四个文件放进两个会话，再把同一句任务交给同一个模型。一边只准用这个工具，另一边没有专用工具，可以随便用终端和 Node。
−53%
费用减少
−93%
用时减少
| 空手 | ezpzfile MCP | |
|---|---|---|
| 费用 | $0.28 | $0.13 |
| 用时 | 9:06 | 0:39 |
| 完成的任务 | 2 / 4 | 4 / 4 |
| 工具调用 | 20 | 10 |
| 来回的 token | 510,607 | 184,605 |
交代的四件事
- 1把两个 PDF 接起来并删掉三页
- 2把照片缩到宽 1200 并清掉定位信息
- 3把 HWP 文档转成 PDF
- 4从 HWP 文档里取出正文
空手那边四件只做完两件。两个韩文文档的活儿，时间全花在找库和装库上，根本没开工。所以上面的差距要当成「至少这么多」来读。真让它把四件都做完，差距只会更大。
token 和费用不是估算，是会话逐条记录的实际用量加总。测量日期： 2026-09-12
三十一件事，六个工具
没有把站上的工具一个个搬过来。工具说明每次对话都占着模型的上下文，摊开三十一个，省下的 token 又被这份清单吃回去。做法相同的归到一起，用参数来分。
doc_read从 DOCX、PDF、HWP、HWPX、EML、JTD、XDW 里把正文取成文字，表格和页眉也一并读出，还能列出文件自带的信息，比如照片的拍摄地点。doc_convert把文档转成 PDF（包括日本的 JTD、XDW），把 PDF 还原成 Word、Excel 或 HWP，PDF 转 JPG、PNG，表格转 CSV、JSON，也在韩文格式之间互转。pdf_edit合并 PDF、拆分、删页、旋转、调顺序、压小体积、加密或解密，还能原地替换文字。pdf_info返回 PDF 的页数、页面尺寸和文档信息。image_edit缩小图片尺寸和体积（也能读 iPhone 的 HEIC）、改格式、抠掉背景、清除残留的定位和相机信息。qr_make把链接或文字做成可以打印分发的二维码。
0.4.0 新增了什么
工具还是六个，接下的站内功能从二十五件增加到三十一件。新功能都作为现有工具的选项加入，所以代理每次对话开头加载的工具清单几乎没有变长。
ezpzfile-mcp@0.4.0
PDF 转回 Word、Excel、HWP
把段落和表格还原成可以编辑的文字。工具会重新打开自己生成的文件核对，没能搬过去的页面（比如没有文字的扫描页）会列出来。
doc_convert to: docx | xlsx | hwp | hwpx替换 PDF 里的文字
在原位置替换词句。原字体里有需要的字，就沿用原字体。替换完会数出还剩几处，漏掉的地方不会被埋没。
pdf_edit op: replace_text一太郎和 DocuWorks
不装这两个软件，也能读取日本的一太郎（.jtd）和 DocuWorks（.xdw、.xbd）文档，并转成 PDF。一太郎文档还能转成 Word。
doc_read · doc_convert .jtd .xdw .xbdiPhone 照片（HEIC）
缩小 HEIC 照片、转换格式，也能和其他图片一起合成一个 PDF。输出为 JPEG、PNG 或 WebP。
image_edit .heic查看文件里留下的信息
显示照片的拍摄地点和相机，以及文档的作者和日期。只是查看不会改动文件。要从照片或 PDF 里清掉，用 image_edit 的 strip_metadata。
doc_read format: metadataHWP 打不开时说清原因
会分辨它是只有名字叫 HWP 的 PDF 或 Word 文件、没下载完的文件，还是被公司安全系统（DRM）锁住的副本。某个文件让引擎停下，下一个文件照样处理。
doc_read "Only the name says HWP: this is a PDF."
一次调用有多快
服务器保持运行，每个调用测五次，取中间值。输入是 2.2MB 15 页的 PDF、342KB 的 HWP、3000x2000 的 JPEG。
| 调用 | 中位数 |
|---|---|
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
服务器启动到第一次响应
~2,000
工具说明每次对话占用的 token
安装
选你在用的工具，复制一行就好。
claude mcp add ezpzfile -- npx -y ezpzfile-mcp在任意终端里执行一次就行。
Node 22.13 以上即可。只在第一次下载，之后直接从缓存启动。
接好之后可以这样吩咐
- “把第一章和第二章的 PDF 接起来，去掉第 3 页”
- “把 ~/Downloads/quote.pdf 转成能编辑的 Word 文件”
- “把 contract.pdf 里的 ACME 全部换成 Globex”
- “把这些照片缩到宽 1200，顺便清掉定位信息”
- “把 ~/Downloads/notice.hwp 转成 PDF”
- 不用为每个文件写转换代码再调试。需要的工具已经接好了。
- 会把生成的文件再读一遍核对页数，有没搬过去的就告诉你数量。
- 全部在这台电脑里运行。文件不会被送到任何地方，涉密文档也能放心交给它。
常见问题
文件真的不会外传吗+
不会。文档引擎和字体都装在包里，读取和转换断网也能用。唯一要联网的是第一次抠背景的时候：从 ezpzfile.com 下载一次抠图模型（约 18MB），存在本机磁盘上。照片不会被发送到任何地方。仓库是公开的，你可以自己核对。
要花钱吗+
不要。MIT 许可，发布在 npm 上。不用账号，也不用密钥。
ChatGPT 或 Grok 上能用吗+
暂时不能。那两家只接受用网址连接的远程 MCP。这个工具为了不让文件外传，特意选了在本机运行的方式。Claude、Cursor、VS Code、Gemini CLI 现在就能用。
处理 HWP 需要装韩文办公软件吗+
不需要，也不需要 Windows。读取和绘制韩文文档的引擎随包一起发出，在 macOS 和 Linux 上一样能跑。
为什么只有六个工具+
工具说明会在每次对话开始时进入模型的上下文。把三十一件事各做成一个工具，这份清单反而会吃掉想省下来的 token。所以做法相同的归到一起，用参数来分。功能增加时也不加工具。
怎么知道结果没问题+
工具会自己核对并告诉你。它把刚写好的文件再读一遍核对页数，字体里缺字就数出来。目的是让悄悄出错的结果变成一个数字，而不是以后才发现的意外。