PDF Content Search MCP

Servidor MCP de Busca de Conteúdo em PDF

Busca em texto completo em PDFs + OCR para Claude, Cursor e qualquer cliente MCP.

Esta é a ponte oficial do Model Context Protocol para o PDF Content Search — um app nativo para macOS que indexa milhares de PDFs (inclusive digitalizados, via OCR do Apple Vision) e encontra qualquer coisa em menos de um segundo.

Você precisa ter o app PDF Content Search instalado e em execução. Este servidor MCP é uma ponte stdio→HTTP — o índice, o mecanismo de OCR e a busca ficam no app. Obtenha o PDF Content Search em store.juergenkoller.software/apps/pdf-content-search.

---

O que você pode fazer

"Claude, encontre todas as faturas da Telekom em 2024 em todos os meus PDFs e liste valor + data."

"Cursor, pesquise 'contrato de processamento de dados' na minha pasta de contratos, retorne o PDF correspondente + o número da página."

O app expõe ferramentas de busca, filtro, OCR, indexação e metadados de documentos por meio do MCP. Os resultados de busca incluem números de página, trechos destacados e coordenadas de bounding-box do OCR. A lista completa de ferramentas é anunciada pelo servidor em tools/list após initialize.

---

Instalação

Pré-requisitos

1. macOS 12 (Monterey) ou superior
2. App PDF Content Search instalado e em execução — obtenha aqui (compra única de €89,99, teste gratuito de 30 dias, inclui apps complementares gratuitos de digitalização para iOS + Android)
3. Swift 5.9+ (Xcode 15+) se for compilar a partir do código-fonte

Compilar a partir do código-fonte

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

Binário universal (para distribuir dentro do bundle do app):

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

Já incluído no app

Se você tem o PDF Content Search instalado, a ponte vem dentro do bundle do app em Contents/Resources/pdf-content-search-mcp. Use o botão "Set up Claude Desktop" no app para configurar automaticamente o Claude Desktop com o caminho e o token corretos — esse é o caminho recomendado para usuários finais.

Este repositório é o código-fonte dessa ponte incluída no app, mantido aberto para que você possa auditá-lo, fazer fork ou executá-lo no seu próprio sandbox.

---

Configuração

Claude Desktop

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

Obtenha o PDF_CS_TOKEN em PDF Content Search → Settings → API Server, ou use o botão "Set up Claude Desktop" dentro do 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 / outros clientes MCP

Mesmo padrão — servidor MCP via stdio.

---

Variáveis de ambiente

Variável	Padrão	Descrição
PDF_CS_TOKEN	(nenhum)	Token Bearer correspondente ao token do API Server do app (obrigatório)
PDF_CS_PORT	44477	Porta do servidor de API do app
PDF_CS_HOST	127.0.0.1	Host para alcançar o app

---

Comportamento do protocolo

• JSON delimitado por quebras de linha em stdin/stdout (transporte stdio do MCP).
• Cada linha é enviada via POST, sem alterações, ao endpoint /mcp do app.
• O cabeçalho Mcp-Session-Id da primeira resposta é armazenado em cache e enviado em todas as requisições subsequentes, de modo que o estado da sessão sobrevive entre mensagens.
• Notificações (requisições sem id) esperam HTTP 202 e não produzem saída em stdout.
• Erros de transporte são convertidos em respostas de erro JSON-RPC (código -32000 "Cannot reach PDF Content Search") para que o cliente exiba uma mensagem significativa em vez de travar.
• HTTP 401 → erro JSON-RPC -32001 com uma dica para executar a configuração novamente.
• HTTP 404 em uma sessão estabelecida descarta o ID em cache e instrui o cliente a reinicializar.

---

Como funciona

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

O PDF Content Search é responsável pelo índice (texto completo + OCR + metadados extraídos), pelo pipeline de nomeação por IA, pela sincronização com iOS/Android e pelo mecanismo de busca. Esta ponte mantém o transporte MCP via stdio como código aberto para que você possa auditar o formato de transmissão de forma independente.

---

Sobre o PDF Content Search

O PDF Content Search substitui estruturas de pastas complexas por uma busca em texto completo extremamente rápida. Destaques:

• Compra única — €89,99, sem assinatura
• Busca em texto completo em milhares de PDFs em menos de um segundo
• Reconhecimento de texto por OCR — Apple Vision Framework, torna digitalizações pesquisáveis
• Nomeação de arquivos por IA — foto de fatura tirada no celular vira 250401 Invoice Telekom.pdf
• Apps complementares gratuitos — apps de digitalização para iOS e Android incluídos
• Sincronização criptografada com o Mac
• Filtros avançados — data, categoria, remetente, valor; operadores booleanos; curingas
• Integração com Spotlight + iCloud Drive
• Servidor MCP (este repositório) + API REST
• Feito para escritórios, bancas de advocacia, contadores — qualquer pessoa com muitos documentos

→ Obtenha o PDF Content Search em store.juergenkoller.software

---

Licença

MIT — consulte LICENSE. Ponte de código aberto; o app PDF Content Search é comercial.

Problemas e suporte

• Bugs da ponte: abra uma issue
• Suporte do app: support@juergenkoller.software

Desenvolvido por Juergen Koller Software GmbH.