PDF Content Search MCP

PDF Content Search MCP Server

Полнотекстовый поиск по PDF + OCR для Claude, Cursor и любого MCP-клиента.

Это официальный мост Model Context Protocol для PDF Content Search — нативного приложения для macOS, которое индексирует тысячи PDF-файлов (включая отсканированные, через Apple Vision OCR) и находит что угодно менее чем за секунду.

Вам нужно установить и запустить приложение PDF Content Search. Этот MCP-сервер — мост stdio→HTTP: индекс, OCR-движок и поиск находятся в приложении. Скачать PDF Content Search можно на store.juergenkoller.software/apps/pdf-content-search.

---

Что вы можете делать

«Claude, найди все счета от Telekom за 2024 год во всех моих PDF-файлах и выведи сумму + дату.»

«Cursor, найди "data processing agreement" в моей папке с договорами, верни подходящий PDF + номер страницы.»

Приложение предоставляет через MCP инструменты поиска, фильтрации, OCR, индексации и метаданных документов. Результаты поиска включают номера страниц, подсвеченные фрагменты и координаты ограничивающих рамок из OCR. Полный список инструментов объявляется сервером на tools/list после initialize.

---

Установка

Предварительные требования

1. macOS 12 (Monterey) или новее
2. Приложение PDF Content Search установлено и запущено — скачать здесь (разовая покупка €89.99, 30-дневная бесплатная пробная версия, включает бесплатные приложения-сканеры для iOS + Android)
3. Swift 5.9+ (Xcode 15+), если собираете из исходников

Сборка из исходников

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

Универсальный бинарник (для поставки внутри пакета приложения):

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

Уже внутри приложения

Если у вас установлен PDF Content Search, мост поставляется внутри пакета приложения по пути Contents/Resources/pdf-content-search-mcp. Используйте кнопку «Set up Claude Desktop» в приложении, чтобы автоматически настроить Claude Desktop с правильным путём и токеном — это рекомендуемый способ для конечных пользователей.

Этот репозиторий — исходный код этого встроенного моста, открытый, чтобы вы могли его проверить, форкнуть или запустить в собственной песочнице.

---

Конфигурация

Claude Desktop

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

Получите PDF_CS_TOKEN в PDF Content Search → Settings → API Server или используйте кнопку «Set up Claude Desktop» в приложении.

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 / другие MCP-клиенты

Тот же принцип — stdio MCP-сервер.

---

Переменные окружения

Переменная	По умолчанию	Описание
PDF_CS_TOKEN	(нет)	Bearer-токен, совпадающий с токеном API Server приложения (обязательно)
PDF_CS_PORT	44477	Порт API-сервера приложения
PDF_CS_HOST	127.0.0.1	Хост для доступа к приложению

---

Поведение протокола

• JSON с разделением по строкам на stdin/stdout (транспорт MCP stdio).
• Каждая строка дословно отправляется POST-запросом на эндпоинт /mcp приложения.
• Заголовок Mcp-Session-Id из первого ответа кэшируется и отправляется с каждым последующим запросом, поэтому состояние сессии сохраняется между сообщениями.
• Уведомления (запросы без id) ожидают HTTP 202 и не выводят ничего в stdout.
• Ошибки транспорта преобразуются в ответы об ошибках JSON-RPC (код -32000 "Cannot reach PDF Content Search"), чтобы клиент показывал понятное сообщение вместо зависания.
• HTTP 401 → ошибка JSON-RPC -32001 с подсказкой повторить настройку.
• HTTP 404 при установленной сессии сбрасывает кэшированный ID и сообщает клиенту о необходимости повторной инициализации.

---

Как это работает

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

PDF Content Search владеет индексом (полнотекстовый поиск + OCR + извлечённые метаданные), конвейером AI-именования, синхронизацией с iOS/Android и поисковым движком. Этот мост сохраняет транспорт MCP stdio открытым, чтобы вы могли независимо проверить формат обмена данными.

---

О PDF Content Search

PDF Content Search заменяет сложные структуры папок молниеносным полнотекстовым поиском. Основные возможности:

• Разовая покупка — €89.99, без подписки
• Полнотекстовый поиск по тысячам PDF-файлов менее чем за секунду
• Распознавание текста OCR — Apple Vision Framework, делает сканы доступными для поиска
• AI-именование файлов — фото счёта с телефона превращается в 250401 Invoice Telekom.pdf
• Бесплатные сопутствующие приложения — включены сканеры для iOS и Android
• Зашифрованная синхронизация с Mac
• Расширенные фильтры — дата, категория, отправитель, сумма; логические операторы; подстановочные знаки
• Интеграция со Spotlight + iCloud Drive
• MCP-сервер (этот репозиторий) + REST API
• Создано для офисов, юридических фирм, бухгалтеров — всех, у кого много документов

→ Скачать PDF Content Search на store.juergenkoller.software

---

Лицензия

MIT — см. LICENSE. Мост с открытым исходным кодом; приложение PDF Content Search — коммерческое.

Проблемы и поддержка

• Ошибки моста: открыть issue
• Поддержка приложения: support@juergenkoller.software

Разработано Juergen Koller Software GmbH.