Zed + pdfmcp：设置指南

将 pdfmcp 作为上下文服务器添加到 Zed 的智能体面板。

仅限本地。相同的 74 个工具，在您的机器上运行：无账户、无密钥、无限制。使用 Zed 时，本页的配置会在您的机器上运行 pdfmcp；通过更换配置，您可以随时重新安装或更换客户端。

您需要： 本地 pdfmcp 软件包：安装一次（或让 uvx 在首次启动时下载它）。无账户、无密钥，没有任何秘密需要替换。

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

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

步骤

Save the config at the location above — uvx fetches the pdfmcp package on first launch, so there is nothing to install by hand (or install it once with the pip command on the MCP page and use "command": "pdfmcp").
Restart Zed so it loads the new server.
Ask the agent to run a pdfmcp tool — it executes on this machine, and your files never leave it.

故障排除

本地服务器无法启动：先用 pip install https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl 安装一次软件包，并在终端中运行 pdfmcp 查看错误——通常是软件包下载被拦截，或 Python 版本低于 3.11。
工具未出现：编辑其配置后，请完全重新启动客户端；大多数客户端仅在启动时加载 MCP 服务器。
某个引擎无法启动：较重的引擎会在首次使用时只下载一次；请检查该次下载的连接并重试：之后一切都在本地运行。

试试这些

设备端处理PDF 信息与元数据以 JSON 提供页数、页面大小、元数据和加密状态。设备端处理合并 PDF按上传顺序将多个 PDF 文件合并为一个。设备端处理PDF 转文本提取纯文本，每页一个以换页符分隔的部分。