TruePath PDF

TruePath PDF — MCP 服务

让 AI 在本地处理 PDF。文件绝不会离开你的 Mac。

@truepathpdf/mcp-server 是一个 Model Context Protocol 服务，让 Claude、Cursor 及任何其他兼容 MCP 的客户端都能读取和处理你设备上的 PDF 文件，无需将文件上传到任何地方。

该服务由 Joy Truepath Pte. Ltd. 开发并维护，该团队也是 TruePath PDF Mac 应用的开发团队。

状态

v0.3 — 免费版功能已全部完成（9 项工具中的 9 项）。 读取 + 编辑 + 栅格化 + GUI 移交：get_info、extract_text、search、split、merge、pages、to_images、extract_images、open_in_truepath。完整的 Pro 版（redact、fill_form、flatten、sign、compress、annotate、autocrop、batch、ocr）将在 v0.4 中推出，并由 Ed25519 许可证密钥控制。

open_in_truepath 需要安装 TruePath PDF Mac 应用v1.0.1 或更高版本（truepath:// 处理程序是在 1.0.1 中添加的；v1.0.0 版本不会注册该处理程序）。

隐私

• 100% 本地运行。MCP 服务在你的设备上运行，绝不会连接网络。
• 无遥测、无分析、无自动回传。
• 免费工具始终可完全离线使用，无需密钥。
• Pro 工具（即将推出）由离线 Ed25519 许可证检查控制——使用时仍不会发起网络请求。

安装

# npx — no install required
npx -y @truepathpdf/mcp-server

# or install globally
npm install -g @truepathpdf/mcp-server
truepath-pdf-mcp

需要 Node.js 22.13 或更高版本（PDF.js 6 需要此版本）。

连接到 Claude Desktop

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "truepath-pdf": {
      "command": "npx",
      "args": ["-y", "@truepathpdf/mcp-server"]
    }
  }
}

重启 Claude Desktop。工具栏中会显示 truepath-pdf 工具。

工具（v0.2）

get_info

页数、第一页尺寸（包含 allSameSize 标记）、加密状态以及嵌入的 PDF 元数据（标题、作者、日期、制作程序、格式版本）。

{ "path": "/Users/you/Documents/report.pdf" }

extract_text

提取纯文本。可选的 1-based 页码范围（"3"、"1-5"、"1,3,5-7"）。输出按页分组，并使用 ===== Page N ===== 标记，方便模型引用正确的页码。

{ "path": "/Users/you/Documents/report.pdf", "pages": "1-3" }

search

在整个文档中搜索子字符串。返回每个匹配项所在页码、在页内的偏移量以及周边文本片段。可先用它进行类似 grep 的查找，再使用开销更大的 extract_text。

{ "path": "/Users/you/Documents/report.pdf", "query": "revenue", "contextChars": 80 }

split

按页码范围将一个 PDF 拆分成 N 份。每个范围生成一个输出文件。

{ "path": "/in.pdf", "ranges": ["1-3", "4-7", "8"], "outputDir": "/out" }

merge

按指定顺序将两个或更多 PDF 合并为一个文件。

{ "paths": ["/a.pdf", "/b.pdf", "/c.pdf"], "outputPath": "/out/merged.pdf" }

pages

一次性删除、旋转和重新排序页面。先应用 delete（rotate 中的页码对应源 PDF）；然后对剩余页面应用 reorder。

{
  "path": "/in.pdf",
  "outputPath": "/out/edited.pdf",
  "delete": "2,5",
  "rotate": [{ "page": 1, "degrees": 90 }],
  "reorder": [3, 1, 2]
}

to_images

按所选 DPI 将 PDF 页面栅格化为 PNG 或 JPG。常用 DPI：96（屏幕）、150（打印预览）、300（打印）。

{ "path": "/in.pdf", "outputDir": "/out", "pages": "1-5", "dpi": 150, "format": "png" }

extract_images

从 PDF 中提取嵌入的图像，并将每张图像保存为 PNG。报告因像素布局不受支持（CMYK、调色板等）而跳过的图像。

{ "path": "/in.pdf", "outputDir": "/out" }

open_in_truepath

通过 truepath://open?path=… 将本地 PDF 交给 TruePath PDF Mac 应用。此操作会立即返回：macOS 会启动应用（或将请求转交给应用），URL 处理程序则会打开 PDF。可在 MCP 中读取或分析后使用此工具，将用户带入 GUI 进行批注、签名、编辑密文等操作。

{ "path": "/Users/you/Documents/report.pdf" }

重新品牌化的引擎版本可选用 scheme 参数（默认为 truepath；Yochen 核心版本使用 yochenpdf）。

如果未安装此应用（未注册 truepath:// 处理程序——即未安装应用或版本早于 v1.0.1），该工具不会报错。它会返回 handedOff: false，并提供一行 TruePath PDF 下载提示，供你安装后重试。（仅适用于默认的 truepath scheme；自定义 scheme 会直接返回失败。）

路线图

Pro 版（v0.4，Ed25519 许可证密钥，离线验证）

• redact — 使用 PDFium 进行保留文本的涂黑处理（与 Mac 应用使用相同的引擎；文字会从文件中移除，而不只是被遮盖）
• fill_form — 填写 AcroForm 字段，并保存为保留字段值的文件
• flatten — 将已填写的表单／批注烘焙到页面流中
• sign — 放置可见签名并写入已签名的 PDF
• compress — 重新压缩图像／数据流以缩小文件体积
• annotate — 以编程方式添加高亮／下划线／便签
• autocrop — 检测内容边界并裁剪页边距
• batch — 对一组符合 glob 模式的文件应用任意工具
• ocr — Apple Vision OCR（仅限 Mac，在设备端运行，擅长处理中日韩文字）

Pro 密钥可通过 Lemon Squeezy 一次性购买，并将在发布时提供（目标价格：29 美元，包含 12 个月更新）。TruePath PDF Mac 应用的用户可通过应用内按钮兑换 App Store 收据，获取 Pro MCP 密钥。

许可证

MCP 外壳采用 MIT 许可证。传递依赖项：

• @modelcontextprotocol/sdk — MIT
• pdfjs-dist — Apache 2.0
• pdf-lib — MIT
• @napi-rs/canvas — MIT
• zod — MIT

Pro 版还将附带预构建的 PDFium 库（BSD／Apache，与 Chrome 使用的相同）。

联系方式

• 问题反馈：https://github.com/JoyTruepath/truepath-pdf-mcp/issues
• 邮件：[email protected]
• Joy Truepath Pte. Ltd.，新加坡（UEN 202205336E）