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/