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把連結或文字做成可以列印分送的 QR Code。
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。所以做法相同的歸在一起，用參數來分。功能增加時也不加工具。
怎麼知道結果沒問題+
工具會自己核對並告訴你。它把剛寫好的檔案再讀一遍核對頁數，字型裡缺字就數出來。目的是讓悄悄出錯的結果變成一個數字，而不是以後才發現的意外。