Windsurf + pdfmcp: руководство по настройке

Добавьте pdfmcp в Windsurf Cascade через mcp_config.json.

Только локально. Те же 74 инструментов, работающие на вашей машине: без аккаунта, без ключа, без лимитов. С Windsurf конфигурация на этой странице запускает pdfmcp на вашей машине; вы можете переустановить или сменить клиента в любое время, поменяв конфигурацию.

Что вам нужно: локальный пакет pdfmcp: установите его один раз (или позвольте uvx скачать его при первом запуске). Без аккаунта, без ключа и без секрета для замены.

Куда это вставляется: Wherever your client keeps its MCP server list

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

Шаги

1. 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").
2. Restart Windsurf so it loads the new server.
3. 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-серверы только при запуске.
• Движок не запускается: тяжёлые движки скачиваются только один раз при первом использовании; проверьте соединение для этой загрузки и попробуйте снова: потом всё работает локально.

Попробуйте с

Другие клиенты: Claude Desktop Настройка MCP · Claude Code Настройка MCP · ChatGPT Настройка MCP · Все руководства по настройке MCP · Руководство по локальному API