Claude Desktop + pdfmcp：設定指南

將 pdfmcp 新增到 Claude Desktop 作為本地 MCP 伺服器。

僅限本地。相同的 74 個工具，在您的機器上執行：無賬戶、無金鑰、無限制。使用 Claude Desktop 時，本頁的配置會在您的機器上執行 pdfmcp；透過更換配置，您可以隨時重新安裝或更換客戶端。

您需要： 本地 pdfmcp 軟體包：安裝一次（或讓 uvx 在首次啟動時下載它）。無賬戶、無金鑰，沒有任何秘密需要替換。

它放在哪裡： claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config)

{
  "mcpServers": {
    "pdfmcp": {
      "command": "uvx",
      "args": [
        "--from",
        "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl",
        "pdfmcp"
      ]
    }
  }
}

步驟

Merge the config below into claude_desktop_config.json (create the file if it doesn't exist).
Fully restart Claude Desktop.
Drop in a PDF and ask Claude to extract the text — it happens on this machine.

Local servers live in the config file — the Settings → Connectors UI is for remote servers and can't start local processes.

uvx downloads the pdfmcp package on first launch and keeps it cached. No key is involved: the tools run on this machine.

疑難排解

本機伺服器無法啟動：先用 pip install https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl 安裝一次套件，並在終端機中執行 pdfmcp 查看錯誤——通常是套件下載被攔截，或 Python 版本低於 3.11。
工具未出現：編輯其配置後，請完全重新啟動客戶端；大多數客戶端僅在啟動時載入 MCP 伺服器。
某個引擎無法啟動：較重的引擎會在首次使用時只下載一次；請檢查該次下載的連線並重試：之後一切都在本地執行。

試試這些

裝置端處理PDF 轉文字擷取純文字，每頁一個以換頁符分隔的部分。裝置端處理壓縮 PDF使用 Ghostscript 減小檔案大小。預設：輕度（列印品質）、中度（電子書）、重度（螢幕，最小）。本地 · MCPOCR — 可搜尋的 PDF使掃描的 PDF 可搜尋：沒有文字層的頁面使用 Tesseract 進行 OCR 並獲得不可見文字層；已有文字的頁面直接通過並報告為略過。