ezpzfile MCP
Đừng để tác nhân viết lại cùng một đoạn mã xử lý tệp
Một bộ công cụ gắn vào các tác nhân như Claude và Cursor. Sửa một tệp PDF, đọc một tài liệu, đổi định dạng, dọn một tấm ảnh: mỗi việc chỉ còn một lệnh gọi. Tất cả chạy trên máy bạn nên không tệp nào bị gửi đi đâu cả.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpGắn được vào đâu
Khác ở chỗ nào
Trước khi gắn
Ba bốn lượt qua lại- 1Tìm một thư viện dùng được rồi cài.
- 2Viết đoạn mã, gặp kết quả lệch rồi sửa.
- 3Mở kết quả ra nhìn xem đã đúng chưa.
Sau khi gắn
Một lệnh gọi- 1Gọi công cụ một lần.
- 2Tệp kết quả được tạo ngay tại chỗ.
- 3Kết quả đối chiếu số trang và số thứ không chuyển được trả về cùng lúc.
Tiết kiệm được bao nhiêu
Bốn tệp giống hệt nhau được đặt vào hai phiên, rồi cùng một câu giao việc được đưa cho cùng một mô hình. Một bên chỉ được dùng máy chủ này. Bên kia không có công cụ riêng và được tự do dùng shell với Node.
−53%
chi phí giảm
−93%
thời gian giảm
| Tay không | ezpzfile MCP | |
|---|---|---|
| Chi phí | $0.28 | $0.13 |
| Thời gian | 9:06 | 0:39 |
| Việc đã xong | 2 / 4 | 4 / 4 |
| Lượt gọi công cụ | 20 | 10 |
| Token đã trao đổi | 510,607 | 184,605 |
Bốn việc đã giao
- 1Ghép hai tệp PDF rồi xoá ba trang
- 2Thu ảnh còn rộng 1200 và xoá dữ liệu vị trí
- 3Đổi một tài liệu HWP sang PDF
- 4Rút nội dung chữ ra khỏi tài liệu HWP
Bên tay không chỉ xong hai trong bốn việc. Hai việc với tài liệu Hàn Quốc thì tiêu hết thời gian vào việc tìm và cài thư viện, chưa kịp bắt đầu. Vậy nên hãy đọc khoảng cách ở trên là “ít nhất chừng này”. Nếu bắt làm cho xong cả bốn, khoảng cách còn rộng hơn.
Token và chi phí không phải ước lượng. Đó là số liệu thật mà phiên ghi lại theo từng tin nhắn, cộng lại. Đo ngày 2026-09-12
Ba mươi mốt việc, sáu công cụ
Các công cụ trên trang không được liệt kê từng cái một ở đây. Phần mô tả công cụ nằm trong ngữ cảnh của mô hình ở mọi cuộc trò chuyện, nên trải hết ba mươi mốt cái ra thì chính danh sách đó ăn mất số token mà ta muốn tiết kiệm. Những việc làm giống nhau được gộp lại, và một tham số chọn giữa chúng.
doc_readRút phần chữ ra khỏi tệp DOCX, PDF, HWP, HWPX, EML, JTD và XDW, kể cả bảng và phần đầu trang. Cũng cho xem những gì tệp tự ghi lại, như nơi chụp ảnh.doc_convertTài liệu sang PDF (kể cả JTD và XDW của Nhật), PDF trở lại Word, Excel hoặc HWP, trang PDF sang JPG hoặc PNG, bảng tính sang CSV hoặc JSON, chuyển qua lại giữa các định dạng Hàn Quốc.pdf_editGhép PDF, tách ra, xoá trang, xoay, đổi thứ tự, giảm dung lượng, đặt hoặc gỡ mật khẩu, thay chữ ngay tại chỗ.pdf_infoTrả về số trang, kích thước trang và thông tin tài liệu của một tệp PDF.image_editThu nhỏ kích thước và dung lượng ảnh (kể cả HEIC từ iPhone), đổi định dạng, tách nền, xoá dữ liệu vị trí và máy ảnh còn sót.qr_makeBiến một đường liên kết hay một đoạn chữ thành mã QR có thể in ra và phát đi.
Có gì mới ở bản 0.4.0
Sáu công cụ giờ đảm nhận ba mươi mốt việc của trang, trước đây là hai mươi lăm. Tính năng mới được thêm thành tuỳ chọn của các công cụ sẵn có, nên danh sách mà tác tử nạp ở đầu mỗi cuộc trò chuyện gần như không dài thêm.
ezpzfile-mcp@0.4.0
PDF ngược về Word, Excel và HWP
Đoạn văn và bảng quay về thành chữ sửa được. Công cụ tự mở lại tệp vừa ghi để kiểm tra và liệt kê những trang phải bỏ qua, chẳng hạn trang quét không có chữ.
doc_convert to: docx | xlsx | hwp | hwpxThay chữ trong PDF
Đổi một từ hay một cụm từ ngay tại chỗ, dùng luôn phông của PDF nếu phông ấy có đủ chữ. Xong nó đếm xem còn sót bao nhiêu chỗ, để không chỗ nào bị bỏ lọt.
pdf_edit op: replace_textIchitaro và DocuWorks
Đọc tệp Ichitaro (.jtd) và DocuWorks (.xdw, .xbd) của Nhật mà không cần hai phần mềm ấy, rồi chuyển sang PDF. Tệp Ichitaro còn chuyển được sang Word.
doc_read · doc_convert .jtd .xdw .xbdẢnh iPhone (HEIC)
Thu nhỏ, đổi định dạng ảnh HEIC và gộp chúng vào một PDF cùng ảnh khác. Ảnh ra ở dạng JPEG, PNG hoặc WebP.
image_edit .heicNhững gì tệp tự ghi về mình
Cho biết ảnh chụp ở đâu, bằng máy nào, hay tài liệu do ai viết và vào lúc nào. Chỉ xem thì tệp không đổi. Muốn xoá khỏi ảnh và PDF thì dùng image_edit strip_metadata.
doc_read format: metadataNói rõ lý do khi HWP không mở được
Cho biết tệp thật ra là gì: PDF hay Word mang nhầm tên, bản tải về bị đứt giữa chừng, hay bản sao bị khoá bởi hệ thống bảo mật của công ty (DRM). Bộ máy có hỏng ở một tệp thì tệp sau vẫn được xử lý.
doc_read "Only the name says HWP: this is a PDF."
Một lệnh gọi nhanh cỡ nào
Máy chủ được giữ chạy sẵn, mỗi lệnh gọi được bấm giờ năm lần và lấy giá trị ở giữa. Đầu vào là tệp PDF 15 trang 2.2MB, tệp HWP 342KB và ảnh JPEG 3000x2000.
| Lệnh gọi | Trung vị |
|---|---|
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
Từ lúc máy chủ lên tới câu trả lời đầu tiên
~2,000
Token mà danh sách công cụ chiếm mỗi cuộc trò chuyện
Cài đặt
Chọn công cụ bạn dùng rồi chép một dòng là xong.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpChạy một lần ở bất kỳ cửa sổ dòng lệnh nào.
Cần Node 22.13 trở lên. Lần đầu tải về một lần, sau đó chạy thẳng từ bộ nhớ đệm.
Gắn xong thì có thể nhờ như thế này
- “Ghép chapter1.pdf với chapter2.pdf rồi bỏ trang 3”
- “Chuyển ~/Downloads/quote.pdf thành tệp Word để tôi sửa được”
- “Đổi hết ACME thành Globex trong contract.pdf”
- “Thu các ảnh này còn rộng 1200 và xoá dữ liệu vị trí”
- “Đổi ~/Downloads/notice.hwp sang PDF”
- Không phải viết rồi sửa đoạn mã chuyển đổi cho từng tệp. Công cụ cần dùng đã gắn sẵn.
- Tệp tạo ra được đọc lại để đối chiếu số trang, và thứ nào không chuyển được thì đếm và báo lại.
- Tất cả chạy trên máy bạn. Không tệp nào bị tải lên, nên tài liệu mật cũng giao được.
Câu hỏi thường gặp
Tệp có thật sự không rời khỏi máy không+
Không hề. Các bộ máy đọc tài liệu và cả phông chữ đều nằm trong gói, nên đọc và chuyển đổi chạy được mà không cần internet. Lần tải duy nhất là khi bạn xoá phông nền của ảnh lần đầu: mô hình tách nền (khoảng 18 MB) được tải một lần từ ezpzfile.com rồi để lại trên ổ đĩa. Ảnh của bạn không được gửi đi đâu cả. Kho mã công khai, bạn có thể tự kiểm.
Có mất tiền không+
Không. Giấy phép MIT, phát hành trên npm. Không cần tài khoản, không cần khoá.
Dùng được trong ChatGPT hay Grok không+
Chưa được. Hai nơi đó chỉ nhận máy chủ MCP từ xa kết nối qua địa chỉ web. Công cụ này cố ý chạy trên máy bạn để tệp không rời khỏi đó. Claude, Cursor, VS Code và Gemini CLI thì dùng được ngay.
Xử lý HWP có cần phần mềm văn phòng Hàn Quốc không+
Không cần, Windows cũng không. Bộ máy đọc và vẽ tài liệu Hàn Quốc đi kèm trong gói nên chạy y hệt trên macOS và Linux.
Sao chỉ có sáu công cụ+
Phần mô tả công cụ được nạp vào ngữ cảnh của mô hình ở đầu mỗi cuộc trò chuyện. Biến mỗi việc trong ba mươi mốt việc thành một công cụ riêng thì chính danh sách ấy sẽ ăn mất số token muốn tiết kiệm. Nên những việc làm giống nhau được gộp lại và một tham số chọn giữa chúng. Có thêm tính năng cũng không thêm công cụ.
Làm sao biết kết quả đúng+
Công cụ tự kiểm và báo lại. Nó đọc lại tệp vừa ghi để đối chiếu số trang, và đếm những ký tự mà phông chữ không có. Mục đích là để một kết quả hỏng âm thầm hiện ra thành con số, thay vì thành bất ngờ về sau.
Một dòng là xong
Dán vào cửa sổ dòng lệnh rồi giao cho tác nhân một tệp mà xem. Muốn bỏ thì xoá một dòng trong cấu hình.
claude mcp add ezpzfile -- npx -y ezpzfile-mcp