PDF Content Search MCP

Servidor MCP de búsqueda de contenido en PDF

Búsqueda de texto completo en PDF + OCR para Claude, Cursor y cualquier cliente MCP.

Este es el puente oficial de Model Context Protocol para PDF Content Search, una app nativa de macOS que indexa miles de PDFs (incluidos los escaneados mediante Apple Vision OCR) y encuentra cualquier cosa en menos de un segundo.

Necesitas tener la app PDF Content Search instalada y en ejecución. Este servidor MCP es un puente stdio→HTTP: el índice, el motor OCR y la búsqueda residen en la app. Consigue PDF Content Search en store.juergenkoller.software/apps/pdf-content-search.

---

Qué puedes hacer

"Claude, encuentra todas las facturas de Telekom de 2024 en todos mis PDFs y lista el importe + la fecha."

"Cursor, busca 'acuerdo de tratamiento de datos' en mi carpeta de contratos, devuelve el PDF coincidente + el número de página."

La app expone herramientas de búsqueda, filtrado, OCR, indexación y metadatos de documentos a través de MCP. Los resultados de búsqueda incluyen números de página, fragmentos resaltados y coordenadas de cuadros delimitadores del OCR. El servidor anuncia la lista completa de herramientas en tools/list tras initialize.

---

Instalación

Requisitos previos

1. macOS 12 (Monterey) o posterior
2. App PDF Content Search instalada y en ejecución — consíguela aquí (compra única de 89,99 €, prueba gratuita de 30 días, incluye apps complementarias gratuitas de escáner para iOS y Android)
3. Swift 5.9+ (Xcode 15+) si compilas desde el código fuente

Compilar desde el código fuente

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

Binario universal (para distribuir dentro del paquete de la app):

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

Ya incluido en la app

Si tienes PDF Content Search instalada, el puente se distribuye dentro del paquete de la app en Contents/Resources/pdf-content-search-mcp. Usa el botón "Set up Claude Desktop" de la app para configurar automáticamente Claude Desktop con la ruta y el token correctos; esa es la vía recomendada para los usuarios finales.

Este repositorio es el código fuente de ese puente incluido en la app, mantenido abierto para que puedas auditarlo, bifurcarlo o ejecutarlo en tu propio entorno aislado.

---

Configuración

Claude Desktop

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

Obtén PDF_CS_TOKEN en PDF Content Search → Settings → API Server, o usa el botón "Set up Claude Desktop" de la app.

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 / otros clientes MCP

El mismo patrón: servidor MCP por stdio.

---

Variables de entorno

Variable	Valor predeterminado	Descripción
PDF_CS_TOKEN	(ninguno)	Token Bearer que coincide con el token del API Server de la app (obligatorio)
PDF_CS_PORT	44477	Puerto del servidor API de la app
PDF_CS_HOST	127.0.0.1	Host para acceder a la app

---

Comportamiento del protocolo

• JSON delimitado por saltos de línea en stdin/stdout (transporte stdio de MCP).
• Cada línea se envía mediante POST al endpoint /mcp de la app tal cual.
• El encabezado Mcp-Session-Id de la primera respuesta se almacena en caché y se envía con cada solicitud posterior, de modo que el estado de la sesión se conserva entre mensajes.
• Las notificaciones (solicitudes sin id) esperan un HTTP 202 y no producen salida en stdout.
• Los errores de transporte se convierten en respuestas de error JSON-RPC (código -32000 "Cannot reach PDF Content Search") para que el cliente muestre un mensaje significativo en lugar de quedarse colgado.
• HTTP 401 → error JSON-RPC -32001 con una sugerencia para volver a ejecutar la configuración.
• HTTP 404 en una sesión establecida descarta el ID en caché e indica al cliente que vuelva a inicializar.

---

Cómo funciona

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

PDF Content Search es propietaria del índice (texto completo + OCR + metadatos extraídos), del flujo de nombrado con IA, de la sincronización con iOS/Android y del motor de búsqueda. Este puente mantiene el transporte MCP por stdio como código abierto para que puedas auditar el formato de comunicación de forma independiente.

---

Acerca de PDF Content Search

PDF Content Search sustituye las estructuras de carpetas complejas por una búsqueda de texto completo ultrarrápida. Lo más destacado:

• Compra única — 89,99 €, sin suscripción
• Búsqueda de texto completo en miles de PDFs en menos de un segundo
• Reconocimiento de texto OCR — Apple Vision Framework, hace que los escaneos sean buscables
• Nombrado de archivos con IA — la foto de una factura hecha con el móvil se convierte en 250401 Invoice Telekom.pdf
• Apps complementarias gratuitas — apps de escáner para iOS y Android incluidas
• Sincronización cifrada con el Mac
• Filtros avanzados — fecha, categoría, remitente, importe; operadores booleanos; comodines
• Integración con Spotlight + iCloud Drive
• Servidor MCP (este repositorio) + API REST
• Pensado para oficinas, despachos de abogados y contables — cualquiera que tenga muchos documentos

→ Consigue PDF Content Search en store.juergenkoller.software

---

Licencia

MIT — consulta LICENSE. El puente es de código abierto; la app PDF Content Search es comercial.

Problemas y soporte

• Errores del puente: abre una incidencia
• Soporte de la app: support@juergenkoller.software

Creado por Juergen Koller Software GmbH.