Windsurf + pdfmcp: panduan penyiapan

Tambahkan pdfmcp ke Windsurf Cascade melalui mcp_config.json.

Hanya lokal. Alat yang sama, 74 jumlahnya, berjalan di mesin Anda: tanpa akun, tanpa kunci, tanpa batas. Dengan Windsurf, konfigurasi di halaman ini menjalankan pdfmcp di mesin Anda; Anda dapat memasang ulang atau berganti klien kapan pun dengan menukar konfigurasi.

Yang Anda butuhkan: paket pdfmcp lokal: pasang sekali (atau biarkan uvx mengunduhnya saat pertama kali dimulai). Tanpa akun, tanpa kunci, dan tanpa rahasia yang perlu diganti.

Tempatnya: 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"
      ]
    }
  }
}

Langkah

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.

Pemecahan masalah

• Server lokal tidak mau menyala: instal paket satu kali dengan pip install https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl dan jalankan pdfmcp di terminal untuk melihat errornya — biasanya unduhan paket yang terblokir, atau Python yang lebih lama dari 3.11.
• Alat tidak muncul: mulai ulang klien sepenuhnya setelah mengedit konfigurasinya; kebanyakan klien hanya memuat server MCP saat mulai.
• Sebuah mesin tidak mulai: mesin berat diunduh hanya sekali saat pertama kali digunakan; periksa koneksi Anda untuk unduhan itu dan coba lagi: setelah itu semuanya bekerja secara lokal.

Coba dengan

Klien lainnya: Claude Desktop penyiapan MCP · Claude Code penyiapan MCP · ChatGPT penyiapan MCP · Semua panduan penyiapan MCP · Panduan API lokal