Claude Code + pdfmcp：設定指南

使用一條命令或透過 .mcp.json 將 pdfmcp 新增到 Claude Code。

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

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

它放在哪裡： Wherever your client keeps its MCP server list

claude mcp add pdfmcp -- uvx --from https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl pdfmcp

步驟

Run the command above (or add the JSON below to .mcp.json in your project root).
Restart Claude Code and run /mcp to confirm pdfmcp is connected.
Try: “Use pdfmcp to merge these two PDFs” — it runs on this machine.

Project-scoped .mcp.json alternative (same local server, no key):

設定

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

疑難排解

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

試試這些

裝置端處理壓縮 PDF使用 Ghostscript 減小檔案大小。預設：輕度（列印品質）、中度（電子書）、重度（螢幕，最小）。本地 · MCPOCR — 可搜尋的 PDF使掃描的 PDF 可搜尋：沒有文字層的頁面使用 Tesseract 進行 OCR 並獲得不可見文字層；已有文字的頁面直接通過並報告為略過。本地 · MCPPDF 轉 Word (DOCX)將 PDF 轉換為可編輯的 Word 文件。基於文字的轉換：段落和標題從文字層重建；確切版面、表格和圖像不會保留。