PDF Content Search MCP

Serveur MCP de recherche de contenu PDF

Recherche plein texte dans les PDF + OCR pour Claude, Cursor et tout client MCP.

Ceci est le pont officiel Model Context Protocol pour PDF Content Search — une application macOS native qui indexe des milliers de PDF (y compris les documents numérisés via l'OCR Apple Vision) et trouve n'importe quoi en moins d'une seconde.

Vous devez avoir installé et lancé l'application PDF Content Search. Ce serveur MCP est un pont stdio→HTTP — l'index, le moteur OCR et la recherche résident dans l'application. Obtenez PDF Content Search sur store.juergenkoller.software/apps/pdf-content-search.

---

Ce que vous pouvez faire

« Claude, trouve toutes les factures de Telekom en 2024 dans tous mes PDF et liste le montant + la date. »

« Cursor, recherche "accord de traitement des données" dans mon dossier de contrats, renvoie le PDF correspondant + le numéro de page. »

L'application expose des outils de recherche, de filtrage, d'OCR, d'indexation et de métadonnées de documents via MCP. Les résultats de recherche incluent les numéros de page, les extraits surlignés et les coordonnées de boîtes englobantes issues de l'OCR. La liste complète des outils est annoncée par le serveur sur tools/list après initialize.

---

Installation

Prérequis

1. macOS 12 (Monterey) ou ultérieur
2. Application PDF Content Search installée et lancée — obtenez-la ici (achat unique 89,99 €, essai gratuit de 30 jours, inclut les applications compagnon gratuites de numérisation iOS + Android)
3. Swift 5.9+ (Xcode 15+) si vous compilez depuis les sources

Compiler depuis les sources

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

Binaire universel (pour l'intégrer dans le bundle de l'application) :

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

Déjà intégré dans l'application

Si vous avez installé PDF Content Search, le pont est fourni dans le bundle de l'application à l'emplacement Contents/Resources/pdf-content-search-mcp. Utilisez le bouton « Set up Claude Desktop » dans l'application pour configurer automatiquement Claude Desktop avec le bon chemin et le bon jeton — c'est la voie recommandée pour les utilisateurs finaux.

Ce dépôt est le code source de ce pont intégré, maintenu ouvert pour que vous puissiez l'auditer, le forker ou l'exécuter dans votre propre sandbox.

---

Configuration

Claude Desktop

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

Obtenez PDF_CS_TOKEN depuis PDF Content Search → Settings → API Server, ou utilisez le bouton « Set up Claude Desktop » dans l'application.

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 / autres clients MCP

Même schéma — serveur MCP stdio.

---

Variables d'environnement

Variable	Valeur par défaut	Description
PDF_CS_TOKEN	(aucune)	Jeton Bearer correspondant au jeton de l'API Server de l'application (obligatoire)
PDF_CS_PORT	44477	Port du serveur API de l'application
PDF_CS_HOST	127.0.0.1	Hôte pour joindre l'application

---

Comportement du protocole

• JSON délimité par des retours à la ligne sur stdin/stdout (transport MCP stdio).
• Chaque ligne est POSTée telle quelle vers le point de terminaison /mcp de l'application.
• L'en-tête Mcp-Session-Id de la première réponse est mis en cache et envoyé avec chaque requête suivante, de sorte que l'état de session survit d'un message à l'autre.
• Les notifications (requêtes sans id) attendent un HTTP 202 et ne produisent rien sur stdout.
• Les erreurs de transport sont converties en réponses d'erreur JSON-RPC (code -32000 « Cannot reach PDF Content Search ») afin que le client affiche un message significatif au lieu de rester bloqué.
• HTTP 401 → erreur JSON-RPC -32001 avec une indication de relancer la configuration.
• HTTP 404 sur une session établie supprime l'ID mis en cache et indique au client de réinitialiser.

---

Fonctionnement

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

PDF Content Search détient l'index (plein texte + OCR + métadonnées extraites), le pipeline de nommage par IA, la synchronisation iOS/Android et le moteur de recherche. Ce pont maintient le transport MCP stdio open source afin que vous puissiez auditer indépendamment le format des échanges.

---

À propos de PDF Content Search

PDF Content Search remplace les structures de dossiers complexes par une recherche plein texte ultra-rapide. Points forts :

• Achat unique — 89,99 €, sans abonnement
• Recherche plein texte dans des milliers de PDF en moins d'une seconde
• Reconnaissance de texte OCR — Apple Vision Framework, rend les numérisations interrogeables
• Nommage de fichiers par IA — une photo de facture prise au téléphone devient 250401 Invoice Telekom.pdf
• Applications compagnon gratuites — applications de numérisation iOS et Android incluses
• Synchronisation chiffrée vers le Mac
• Filtres avancés — date, catégorie, expéditeur, montant ; opérateurs booléens ; caractères génériques
• Intégration Spotlight + iCloud Drive
• Serveur MCP (ce dépôt) + API REST
• Conçu pour les bureaux, cabinets d'avocats, comptables — tous ceux qui ont beaucoup de documents

→ Obtenez PDF Content Search sur store.juergenkoller.software

---

Licence

MIT — voir LICENSE. Le pont est open source ; l'application PDF Content Search est commerciale.

Problèmes et support

• Bugs du pont : ouvrir un ticket
• Support de l'application : support@juergenkoller.software

Développé par Juergen Koller Software GmbH.