pdfmcp 入门指南
使用 pdfmcp 的三种本地方式：在您的设备上运行的免费网页工具、供 AI 智能体使用的本地 MCP 服务器，以及从您自己的代码中使用的本地 API，每种方式约一分钟即可就绪。
使用 pdfmcp 的三种方式，全部在本地
pdfmcp 是一个有三扇门的工具箱，而这三扇门都在您这一边。本网站的网页工具在您的浏览器、您的设备上运行：您的文件永不上传，您也无需注册任何东西。本地 MCP 服务器将相同的操作公开为类型化工具，Claude 和 Cursor 等 AI 智能体可以直接调用，运行在您的机器上。而本地 API 让您可以从自己的代码中调用相同的操作，同样在您的机器上。
三者都永久免费。没有付费层级，没有水印，没有试用时钟，没有账户，没有密钥，也没有每日配额：您的设备承担了工作，因此您的设备是唯一的实际限制。
方式 1：使用网页工具（无需注册）
打开工具索引，选择您需要的内容：合并、拆分、压缩、转换、OCR、签名、涂黑等。标有“在您的设备上”的工具完全在此浏览器标签页中处理您的文件：放下文件，调整选项，下载结果。没有任何东西传输给我们，因此没有东西需要保存、记录或泄露。
某些操作需要较重的机械（完整的 OCR、Office 转换、加密）。这些页面标有“本地 · MCP”，并说明如何使用软件包在您的机器上本地运行该工作，具有相同的隐私。
方式 2：安装本地软件包
软件包使用 MCP 页面上的安装命令只需安装一次。之后，它完全在您的机器上运行：没有账户需要创建，没有密钥需要复制，也没有任何东西会过期。
较重的引擎（qpdf、OCR 语言数据）会在首次使用时经 SHA-256 验证后只下载一次，并保留在您的机器上供后续使用。
方式 3：将本地 MCP 服务器连接到您的 AI 智能体
MCP 服务器在与您的智能体相同的机器上本地运行 (stdio)。大多数客户端都接受这种配置形式，由客户端为您启动软件包：
{"mcpServers": {"pdfmcp": {"command": "uvx", "args": ["--from", "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl", "pdfmcp"]}}}编辑其配置后，请重新启动您的客户端；pdfmcp 的工具会出现在它的列表中。MCP 页面链接了 13 个客户端（Claude Desktop、Claude Code、ChatGPT、Cursor、VS Code、Windsurf、Codex、Gemini CLI、Zed、Cline、Continue、JetBrains 以及任何其他 MCP 客户端）的分步指南。ChatGPT 无法启动本地进程，因此在 ChatGPT 内没有本地之门：请改用本地客户端之一。
您的第一次本地调用
从您自己的代码或终端来看，流程与往常相同，但没有远程服务器：安装软件包，选择一项操作，并在您机器上的文件上运行它。该操作在本地读取文件，并在本地写入结果。
本网站的操作目录（每一项操作、其参数和架构）也描述了本地软件包，因为这是同一个目录：您在工具页面上看到的，就是您的智能体和代码可以调用的。
限制与隐私，说真的
唯一的限制是您设备的限制：内存、速度，在浏览器中则是约 100 MB、500 页以内的文件。没有配额需要消耗，也没有队列需要等待。
隐私是架构性的。一切都在本地运行，因此您的文件永不离开您的机器，永不保存在任何服务器上，也永不用于训练 AI。本网站收集的唯一内容是页面分析（浏览量和汇总的 Google Analytics），它绝不触及您的文档。
常见问题
pdfmcp 真的免费吗？
是的，永久免费。所有工具都在本地运行，无账户，无水印。没有付费层级：一个可选的捐赠框（目前已禁用）就是全部商业模式。
我需要账户吗？
不需要。pdfmcp 中没有账户：网页工具没有，本地 MCP 服务器没有，本地 API 也没有。
我的文件会去哪里？
哪里也不去：处理发生在您的设备或机器上，您的文件永不上传，也永不用于训练 AI。
我的智能体如何调用本地 MCP 服务器？
您的客户端会以指南中的配置将 pdfmcp 软件包作为本地进程 (stdio) 启动。由于没有远程服务器，因此没有秘密标头需要配置。
有每日限制吗？
没有。没有每日配额，没有每小时节奏，也没有计数器：您的设备是唯一的实际限制。
我可以离线使用 pdfmcp 吗？
在很大程度上可以：页面及其库加载完成后，网页工具在您的浏览器中工作，本地软件包在您的机器上工作。只有首次使用时的引擎下载需要连接。
原文发表于 https://pdfmcp.org/guides/getting-started/