ezpzfile

Name: ezpzfile
Author: ezpzfile

本地服务

ezpzfile.com生产力54 周前更新

代码仓库访问官网

关于 ezpzfile

ezpzfile-mcp 是本地 MCP 服务，可读取和转换多种文档、编辑 PDF 与图像，并生成二维码。它面向需要在本机处理文件的 Agent，支持多种韩文和日文格式，且不会上传文件。

主要功能

01读取文档并提取表格
02转换文档和 PDF 页面
03编辑并查看 PDF 信息
04调整、转换和清理图像
05生成 PNG 或 SVG 二维码

适用场景

01提取办公文档中的文本和表格
02将 PDF 转换为 Word、Excel 或 HWP
03清理图像元数据或移除背景

MCP 相关

ezpzfile-mcp 向 MCP 客户端提供六种文件处理工具：doc_read、doc_convert、pdf_edit、pdf_info、image_edit 和 qr_make。文件操作在本机运行；README 提到移除背景时会下载并缓存模型和运行时。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ezpzfile-ezpzfile": {
      "command": "npx",
      "args": [
        "-y",
        "ezpzfile-mcp"
      ]
    }
  }
}

启动命令npx -y ezpzfile-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmezpzfile-mcp0.3.3stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
path	string	是	源文件的绝对路径，支持 .hwp、.hwpx、.docx、.pdf 或 .eml。拒绝相对路径
format	enum	否	当格式支持时，markdown 会保留标题、列表和表格（DOCX）。默认值为 texttext \| markdown
password	string	否	仅适用于加密的 PDF、HWP 或 HWPX

详细介绍

ezpzfile-mcp

为 AI Agent 提供文件工具。读取并转换文档（DOCX、PDF、HWP、HWPX、EML，以及日文 JTD 和 XDW），将 PDF 转回 Word、Excel 或 HWP，编辑 PDF、调整图像大小并清理图像、抠出背景、生成二维码。所有操作都在你的设备上运行，不会上传任何文件。

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

npm · ezpzfile.com/mcp · Node 22.13 或更高版本

它能节省什么

将相同的 4 个文件放入两个会话，并把同一句任务描述交给同一个模型。一边只能使用此服务；另一边没有专用工具，可以自由使用 shell 和 Node。

	不使用工具	使用 ezpzfile-mcp
成本	$0.28	$0.13
总耗时	9:06	0:39
完成的任务	2 / 4	4 / 4
工具调用次数	20	10
Token 数	510,607	184,605

成本降低了 53%，耗时减少了 93%。Token 数和成本并非估算值，而是会话记录的每条消息数据汇总后的结果。测量日期：2026-09-12。

基础会话甚至没有开始其中两项任务。它花时间寻找并安装库来处理两份韩文文档。将这项差距视为下限，而非上限：如果要求它完成全部 4 项任务，差距会更大。

基准测试

工具

只有 6 个，而不是 25 个。每次对话中，工具定义都会占用模型的上下文，因此相关任务共用一个工具，再通过参数选择具体操作。mcp/README.md 列出了完整清单和所有参数。

工具	功能
`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`	调整大小、压缩、转换（也支持 iPhone HEIC）、移除 EXIF 和 GPS 信息、抠出背景
`qr_make`	将链接或文本生成为 PNG 或 SVG

目录结构

路径	内容
`mcp/`	软件包：服务、工具、构建
`src/lib/`	与 ezpzfile.com 共用的代码
`public/vendor/`	HWP、JTD 和 XDW 引擎、libheif，以及嵌入生成的 PDF 中的字体（不纳入 git；它们包含在 npm 软件包中）

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

sharp 和 @napi-rs/canvas 是原生模块，因此会在安装时针对你的平台构建。首次请求抠图时，背景移除功能会下载一个 4.4MB 的模型和一个 14MB 的运行时，之后将它们缓存到 ~/.cache/ezpzfile-mcp。这是此项目中唯一会访问网络的功能，而且不会上传任何内容。