PDF Content Search MCP

Server MCP Pencarian Konten PDF

Pencarian teks lengkap PDF + OCR untuk Claude, Cursor, dan klien MCP apa pun.

Ini adalah jembatan resmi Model Context Protocol untuk PDF Content Search — aplikasi native macOS yang mengindeks ribuan PDF (termasuk yang hasil pindai melalui Apple Vision OCR) dan menemukan apa pun dalam waktu kurang dari satu detik.

Anda perlu menginstal dan menjalankan aplikasi PDF Content Search. Server MCP ini adalah jembatan stdio→HTTP — indeks, mesin OCR, dan pencarian berada di dalam aplikasi. Dapatkan PDF Content Search di store.juergenkoller.software/apps/pdf-content-search.

---

Yang dapat Anda lakukan

"Claude, temukan semua faktur dari Telekom pada 2024 di seluruh PDF saya dan daftarkan jumlah + tanggalnya."

"Cursor, cari 'perjanjian pemrosesan data' di folder kontrak saya, kembalikan PDF yang cocok + nomor halamannya."

Aplikasi ini menyediakan alat pencarian, filter, OCR, pengindeksan, dan metadata dokumen melalui MCP. Hasil pencarian mencakup nomor halaman, cuplikan yang disorot, dan koordinat bounding-box dari OCR. Daftar alat lengkap diumumkan oleh server pada tools/list setelah initialize.

---

Instalasi

Prasyarat

1. macOS 12 (Monterey) atau lebih baru
2. Aplikasi PDF Content Search terinstal dan berjalan — dapatkan di sini (pembelian sekali seumur hidup €89,99, uji coba gratis 30 hari, termasuk aplikasi pendamping pemindai iOS + Android gratis)
3. Swift 5.9+ (Xcode 15+) jika membangun dari sumber

Bangun dari sumber

git clone https://github.com/juergenkoller-software/pdf-content-search-mcp.git
cd pdf-content-search-mcp
swift build -c release
# Binary: .build/release/pdf-content-search-mcp

Binary universal (untuk didistribusikan di dalam bundel aplikasi):

swift build -c release --arch arm64 --arch x86_64

Sudah ada di dalam aplikasi

Jika Anda telah menginstal PDF Content Search, jembatan ini sudah disertakan di dalam bundel aplikasi pada Contents/Resources/pdf-content-search-mcp. Gunakan tombol "Set up Claude Desktop" di aplikasi untuk mengonfigurasi Claude Desktop secara otomatis dengan path dan token yang tepat — itu adalah cara yang direkomendasikan untuk pengguna akhir.

Repositori ini adalah kode sumber untuk jembatan yang disertakan tersebut, dibuka agar Anda dapat mengauditnya, mem-fork-nya, atau menjalankannya di sandbox Anda sendiri.

---

Konfigurasi

Claude Desktop

{
  "mcpServers": {
    "pdf-content-search": {
      "command": "/path/to/pdf-content-search-mcp",
      "env": {
        "PDF_CS_TOKEN": "your-token-here",
        "PDF_CS_PORT": "44477"
      }
    }
  }
}

Dapatkan PDF_CS_TOKEN dari PDF Content Search → Settings → API Server, atau gunakan tombol "Set up Claude Desktop" di dalam aplikasi.

Claude Code

claude mcp add pdf-content-search /path/to/pdf-content-search-mcp \
  --env PDF_CS_PORT=44477 \
  --env PDF_CS_TOKEN=your-token-here

Cursor / klien MCP lainnya

Pola yang sama — server MCP stdio.

---

Variabel lingkungan

Variabel	Default	Deskripsi
PDF_CS_TOKEN	(tidak ada)	Token bearer yang cocok dengan token API Server aplikasi (wajib)
PDF_CS_PORT	44477	Port server API aplikasi
PDF_CS_HOST	127.0.0.1	Host untuk menjangkau aplikasi

---

Perilaku protokol

• JSON berbatas baris baru pada stdin/stdout (transport stdio MCP).
• Setiap baris di-POST secara verbatim ke endpoint /mcp aplikasi.
• Header Mcp-Session-Id dari respons pertama di-cache dan dikirim dengan setiap permintaan berikutnya, sehingga status sesi bertahan di seluruh pesan.
• Notifikasi (permintaan tanpa id) mengharapkan HTTP 202 dan tidak menghasilkan stdout.
• Kesalahan transport diubah menjadi respons kesalahan JSON-RPC (kode -32000 "Cannot reach PDF Content Search") agar klien menampilkan pesan yang bermakna alih-alih menggantung.
• HTTP 401 → kesalahan JSON-RPC -32001 dengan petunjuk untuk menjalankan ulang penyiapan.
• HTTP 404 pada sesi yang sudah terbentuk akan menghapus ID yang di-cache dan memberi tahu klien untuk menginisialisasi ulang.

---

Cara kerjanya

┌────────────────┐  JSON-RPC stdio   ┌────────────────┐  HTTP+Bearer   ┌────────────────────┐
│  Claude/Cursor │ ───────────────►  │ pdfcs-mcp      │ ─────────────► │ PDF Content Search │
│  (MCP client)  │ ◄───────────────  │   (this repo)  │ ◄───────────── │  (port 44477)      │
└────────────────┘                   └────────────────┘                └────────────────────┘

PDF Content Search memiliki indeks (teks lengkap + OCR + metadata yang diekstrak), pipeline penamaan AI, sinkronisasi iOS/Android, dan mesin pencari. Jembatan ini menjaga transport stdio MCP tetap open-source agar Anda dapat mengaudit format wire secara independen.

---

Tentang PDF Content Search

PDF Content Search menggantikan struktur folder yang rumit dengan pencarian teks lengkap yang sangat cepat. Sorotan:

• Pembelian sekali seumur hidup — €89,99, tanpa langganan
• Pencarian teks lengkap di ribuan PDF dalam waktu kurang dari satu detik
• Pengenalan teks OCR — Apple Vision Framework, membuat hasil pindai dapat dicari
• Penamaan file AI — foto faktur dari ponsel menjadi 250401 Invoice Telekom.pdf
• Aplikasi pendamping gratis — aplikasi pemindai iOS dan Android disertakan
• Sinkronisasi terenkripsi ke Mac
• Filter lanjutan — tanggal, kategori, pengirim, jumlah; operator boolean; wildcard
• Integrasi Spotlight + iCloud Drive
• Server MCP (repositori ini) + REST API
• Dibuat untuk kantor, firma hukum, akuntan — siapa pun yang memiliki banyak dokumen

→ Dapatkan PDF Content Search di store.juergenkoller.software

---

Lisensi

MIT — lihat LICENSE. Jembatan open source; aplikasi PDF Content Search bersifat komersial.

Masalah & dukungan

• Bug jembatan: buka issue
• Dukungan aplikasi: support@juergenkoller.software

Dibuat oleh Juergen Koller Software GmbH.