PDF Content Search MCP

PDF Content Search MCP 서버

Claude, Cursor 및 모든 MCP 클라이언트를 위한 PDF 전체 텍스트 검색 + OCR.

이것은 PDF Content Search를 위한 공식 Model Context Protocol 브리지입니다. PDF Content Search는 수천 개의 PDF(Apple Vision OCR을 통한 스캔 문서 포함)를 인덱싱하고 1초 이내에 무엇이든 찾아내는 네이티브 macOS 앱입니다.

PDF Content Search 앱이 설치되어 실행 중이어야 합니다. 이 MCP 서버는 stdio→HTTP 브리지이며, 인덱스, OCR 엔진, 검색은 앱 내부에 있습니다. PDF Content Search는 store.juergenkoller.software/apps/pdf-content-search에서 받으세요.

---

할 수 있는 일

"Claude, 내 모든 PDF에서 2024년 Telekom 인보이스를 모두 찾아서 금액과 날짜를 나열해 줘."

"Cursor, 내 계약서 폴더에서 '데이터 처리 계약'을 검색하고 일치하는 PDF와 페이지 번호를 알려 줘."

앱은 MCP를 통해 검색, 필터, OCR, 인덱싱, 문서 메타데이터 도구를 제공합니다. 검색 결과에는 페이지 번호, 하이라이트된 스니펫, OCR의 바운딩 박스 좌표가 포함됩니다. 전체 도구 목록은 initialize 이후 tools/list에서 서버가 알려줍니다.

---

설치

사전 요구 사항

1. macOS 12 (Monterey) 이상
2. PDF Content Search 앱 설치 및 실행 중 — 여기서 받기 (1회 구매 €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	(없음)	앱의 API Server 토큰과 일치하는 베어러 토큰 (필수)
PDF_CS_PORT	44477	앱 API 서버의 포트
PDF_CS_HOST	127.0.0.1	앱에 접근할 호스트

---

프로토콜 동작

• stdin/stdout에서 줄바꿈으로 구분된 JSON (MCP stdio 전송).
• 각 줄은 앱의 /mcp 엔드포인트로 그대로 POST됩니다.
• 첫 번째 응답의 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 동기화, 검색 엔진을 소유합니다. 이 브리지는 stdio MCP 전송을 오픈 소스로 유지하여 전송 형식을 독립적으로 감사할 수 있게 합니다.

---

PDF Content Search 소개

PDF Content Search는 복잡한 폴더 구조를 번개처럼 빠른 전체 텍스트 검색으로 대체합니다. 주요 특징:

• 1회 구매 — €89.99, 구독 없음
• 수천 개의 PDF에 걸친 전체 텍스트 검색을 1초 이내에
• OCR 텍스트 인식 — Apple Vision Framework, 스캔 문서를 검색 가능하게 함
• AI 파일 이름 지정 — 인보이스의 휴대폰 사진이 250401 Invoice Telekom.pdf이 됨
• 무료 동반 앱 — iOS 및 Android 스캐너 앱 포함
• Mac으로의 암호화된 동기화
• 고급 필터 — 날짜, 카테고리, 발신자, 금액; 불리언 연산자; 와일드카드
• Spotlight + iCloud Drive 통합
• MCP 서버(이 저장소) + REST API
• 사무실, 법률 사무소, 회계사를 위해 제작 — 문서가 많은 모든 사람

→ store.juergenkoller.software에서 PDF Content Search 받기

---

라이선스

MIT — LICENSE 참조. 브리지는 오픈 소스이며, PDF Content Search 앱은 상용입니다.

이슈 및 지원

• 브리지 버그: 이슈 열기
• 앱 지원: support@juergenkoller.software

Juergen Koller Software GmbH 제작.