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 文档。基于文本的转换：段落和标题从文本层重建；确切布局、表格和图像不会保留。