Claude Desktop + pdfmcp: panduan penyiapan

Tambahkan pdfmcp ke Claude Desktop sebagai server MCP lokal.

Hanya lokal. Alat yang sama, 74 jumlahnya, berjalan di mesin Anda: tanpa akun, tanpa kunci, tanpa batas. Dengan Claude Desktop, 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: claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config)

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

Langkah

Merge the config below into claude_desktop_config.json (create the file if it doesn't exist).
Fully restart Claude Desktop.
Drop in a PDF and ask Claude to extract the text — it happens on this machine.

Local servers live in the config file — the Settings → Connectors UI is for remote servers and can't start local processes.

uvx downloads the pdfmcp package on first launch and keeps it cached. No key is involved: the tools run on this machine.

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

Di perangkatPDF ke teksEkstrak teks biasa, satu bagian terpisah form-feed per halaman.Di perangkatKompres PDFKurangi ukuran file dengan Ghostscript. Preset: ringan (kualitas printer), sedang (ebook), berat (layar, terkecil).Lokal · MCPOCR — PDF yang dapat dicariBuat PDF hasil pindaian dapat dicari: halaman tanpa lapisan teks di-OCR dengan Tesseract dan mendapatkan lapisan teks tak terlihat; halaman yang sudah memiliki teks diteruskan dan dilaporkan sebagai dilewati.

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