PDF Content Search MCP

PDF Content Search MCP Server

Volltext-PDF-Suche + OCR für Claude, Cursor und jeden MCP-Client.

Dies ist die offizielle Model Context Protocol-Bridge für PDF Content Search — eine native macOS-App, die Tausende von PDFs indexiert (einschließlich gescannter Dokumente via Apple Vision OCR) und alles in unter einer Sekunde findet.

Du benötigst die installierte und laufende PDF Content Search App. Dieser MCP-Server ist eine stdio→HTTP-Bridge — der Index, die OCR-Engine und die Suche befinden sich in der App. Hol dir PDF Content Search unter store.juergenkoller.software/apps/pdf-content-search.

---

Was du tun kannst

„Claude, finde alle Rechnungen von Telekom aus 2024 in allen meinen PDFs und liste Betrag + Datum auf."

„Cursor, durchsuche meinen Vertragsordner nach ‚Auftragsverarbeitungsvertrag' und gib die passende PDF + Seitenzahl zurück."

Die App stellt Such-, Filter-, OCR-, Indexierungs- und Dokument-Metadaten-Tools über MCP bereit. Suchergebnisse enthalten Seitenzahlen, hervorgehobene Textausschnitte und Bounding-Box-Koordinaten aus der OCR. Die vollständige Tool-Liste wird vom Server bei tools/list nach initialize angekündigt.

---

Installation

Voraussetzungen

1. macOS 12 (Monterey) oder neuer
2. PDF Content Search App installiert und laufend — hier erhältlich (Einmalkauf 89,99 €, 30 Tage kostenlose Testversion, inklusive kostenloser iOS- + Android-Scanner-Begleit-Apps)
3. Swift 5.9+ (Xcode 15+), falls aus dem Quellcode gebaut wird

Aus dem Quellcode bauen

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

Universal-Binary (zum Ausliefern im App-Bundle):

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

Bereits in der App enthalten

Wenn du PDF Content Search installiert hast, ist die Bridge im App-Bundle unter Contents/Resources/pdf-content-search-mcp enthalten. Verwende die Schaltfläche „Claude Desktop einrichten" in der App, um Claude Desktop automatisch mit dem richtigen Pfad und Token zu konfigurieren — das ist der empfohlene Weg für Endnutzer.

Dieses Repo ist der Quellcode für diese gebündelte Bridge, der offen gehalten wird, damit du ihn prüfen, forken oder in deiner eigenen Sandbox ausführen kannst.

---

Konfiguration

Claude Desktop

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

Hole PDF_CS_TOKEN aus PDF Content Search → Einstellungen → API-Server oder verwende die In-App-Schaltfläche „Claude Desktop einrichten".

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 / andere MCP-Clients

Gleiches Muster — stdio-MCP-Server.

---

Umgebungsvariablen

Variable	Standard	Beschreibung
PDF_CS_TOKEN	(keine)	Bearer-Token, der mit dem API-Server-Token der App übereinstimmt (erforderlich)
PDF_CS_PORT	44477	Port des API-Servers der App
PDF_CS_HOST	127.0.0.1	Host, über den die App erreicht wird

---

Protokollverhalten

• Zeilengetrenntes JSON auf stdin/stdout (MCP-stdio-Transport).
• Jede Zeile wird unverändert per POST an den /mcp-Endpunkt der App gesendet.
• Der Mcp-Session-Id-Header der ersten Antwort wird zwischengespeichert und mit jeder nachfolgenden Anfrage gesendet, sodass der Sitzungszustand über Nachrichten hinweg erhalten bleibt.
• Benachrichtigungen (Anfragen ohne id) erwarten HTTP 202 und erzeugen keine stdout-Ausgabe.
• Transportfehler werden in JSON-RPC-Fehlerantworten umgewandelt (Code -32000 „Cannot reach PDF Content Search"), damit der Client eine aussagekräftige Meldung anzeigt, statt zu hängen.
• HTTP 401 → JSON-RPC-Fehler -32001 mit einem Hinweis, das Setup erneut auszuführen.
• HTTP 404 bei einer bestehenden Sitzung verwirft die zwischengespeicherte ID und fordert den Client auf, neu zu initialisieren.

---

So funktioniert es

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

PDF Content Search besitzt den Index (Volltext + OCR + extrahierte Metadaten), die KI-Benennungs-Pipeline, die iOS/Android-Synchronisierung und die Suchmaschine. Diese Bridge hält den stdio-MCP-Transport quelloffen, damit du das Wire-Format unabhängig prüfen kannst.

---

Über PDF Content Search

PDF Content Search ersetzt komplexe Ordnerstrukturen durch blitzschnelle Volltextsuche. Highlights:

• Einmalkauf — 89,99 €, kein Abonnement
• Volltextsuche über Tausende von PDFs in unter einer Sekunde
• OCR-Texterkennung — Apple Vision Framework, macht Scans durchsuchbar
• KI-Dateibenennung — Handyfoto einer Rechnung wird zu 250401 Invoice Telekom.pdf
• Kostenlose Begleit-Apps — iOS- und Android-Scanner-Apps inklusive
• Verschlüsselte Synchronisierung zum Mac
• Erweiterte Filter — Datum, Kategorie, Absender, Betrag; boolesche Operatoren; Platzhalter
• Spotlight + iCloud Drive-Integration
• MCP-Server (dieses Repo) + REST-API
• Gemacht für Büros, Kanzleien, Steuerberater — alle mit vielen Dokumenten

→ Hol dir PDF Content Search unter store.juergenkoller.software

---

Lizenz

MIT — siehe LICENSE. Bridge ist quelloffen; die PDF Content Search App ist kommerziell.

Probleme & Support

• Bridge-Fehler: Issue eröffnen
• App-Support: support@juergenkoller.software

Entwickelt von Juergen Koller Software GmbH.