Ezpzfile

io.github.ezpzfile由 GitHub 账号 ezpzfile 发布v0.3.3更新于 Oct 24, 2026

Local file tools for agents: documents, PDFs, images, QR codes. Nothing is uploaded.

已验证STDIO仅桌面文件与存储媒体与设计

概览

AI 生成的概览

面向 AI 助手的本地文件工具：读取和转换文档、PDF 与图片，编辑 PDF，抠图去背景，并生成二维码。

可以做什么
提供六个本地文件处理工具：doc_read 从 DOCX、PDF、HWP、HWPX、EML、JTD 和 XDW 文件中提取文本和表格；doc_convert 将文档转为 PDF、把 PDF 转回 Word、Excel 或 HWP、把 PDF 页面转为图片、把表格转为 CSV 或 JSON；pdf_edit 支持合并、提取、删除、旋转、重排、拆分、压缩、加密、解锁和替换文本；pdf_info 报告页数、页面尺寸、加密状态和元数据；image_edit 可调整尺寸、压缩、转换格式、清除 EXIF 和 GPS、抠图去背景；qr_make 把链接或文本生成 PNG 或 SVG。
适用场景
适合助手需要在不上传文件的前提下处理本地文档、PDF 或图片的场景，尤其是 HWP、HWPX、JTD、XDW 等韩文和日文格式，以及 PDF 编辑和图片清理任务。
运行要求
通过 stdio 在本地运行，使用 npx 从 npm 包 ezpzfile-mcp 安装。需要 Node 22.13 或更高版本。原生模块（sharp、@napi-rs/canvas）会在安装时按平台构建。首次使用抠图功能时会下载模型和运行时，并缓存到 ~/.cache/ezpzfile-mcp。未声明账号、API 密钥或环境变量。
安装前请注意
文件在本机处理，README 称不会上传任何文件；唯一的网络访问是首次抠图时的模型下载。这些工具可以写入、转换、合并、拆分、压缩、加密、解锁和替换 PDF 文本，并可清除图片的 EXIF 或 GPS 信息，因此执行破坏性或影响隐私的操作前应先确认。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Ezpzfile，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

ezpzfile-mcp

File tools for AI agents. Read and convert documents (DOCX, PDF, HWP, HWPX, EML, and Japanese JTD and XDW), turn PDFs back into Word, Excel or HWP, edit PDFs, resize and clean images, cut out backgrounds, make QR codes. Everything runs on your machine and no file is ever uploaded.

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

npm · ezpzfile.com/mcp · Node 22.13 or newer

What it saves

The same four files were placed in two sessions and the same task sentence was handed to the same model. One side could only use this server. The other had no dedicated tools and was free to use the shell and Node.

Without toolsWith ezpzfile-mcp
Cost$0.28$0.13
Wall time9:060:39
Tasks finished2 / 44 / 4
Tool calls2010
Tokens510,607184,605

That is 53% less cost and 93% less time. Tokens and cost are not estimates; they are the per-message figures the sessions recorded, added up. Measured 2026-09-12.

The bare session never started two of the tasks. It spent the clock hunting for and installing libraries for the two Korean documents. Read the gap as a floor, not a ceiling: had it been made to finish all 4, the difference would be wider.

[Benchmark]

The tools

Six of them, not twenty five. Tool definitions sit in the model's context for every conversation, so related jobs share one tool and an argument picks between them. mcp/README.md has the full list and every argument.

ToolWhat it does
doc_readText out of DOCX, PDF, HWP, HWPX, EML, JTD and XDW, tables included, or what a file records about itself
doc_convertDocuments to PDF, PDF back to Word, Excel or HWP, PDF pages to images, sheets to CSV or JSON, Korean formats to each other
pdf_editMerge, extract, delete, rotate, reorder, split, compress, protect, unlock, replace text
pdf_infoPage count, page sizes, encryption, metadata
image_editResize, compress, convert (iPhone HEIC too), strip EXIF and GPS, cut out the background
qr_makeA link or some text as a PNG or SVG

Layout

PathWhat it is
mcp/The package: server, tools, build
src/lib/Code shared with ezpzfile.com
public/vendor/The HWP, JTD and XDW engines, libheif and the fonts embedded into generated PDFs (kept out of git; they ship inside the npm package)
bash
cd mcpnpm installnpm run build      # writes mcp/dist/index.js and mcp/vendor/node test/protocol.mjs /path/to/samples

sharp and @napi-rs/canvas are native, so they are built for your platform on install. Background removal downloads a 4.4MB model and a 14MB runtime the first time you ask for a cut-out, then caches them under ~/.cache/ezpzfile-mcp. That is the only thing here that touches the network, and it uploads nothing.

A note on this repository

This is a read-only export. The working copy lives in a private monorepo alongside the website, and this repository is regenerated from it on each release. Please open issues rather than pull requests.

MIT licensed, see LICENSE.

来源：README.md，提交 49b4fab

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.3.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分