PDF Content Search MCP

官方

開源 MCP 橋接器，用於 PDF 內容搜尋：可直接從 Claude、Cursor 或任何 MCP 用戶端，對數千份本機 PDF、掃描檔與 Apple Mail 郵件進行全文搜尋與 OCR。您的文件會留在您的 Mac 上。

GitHub

你可以用 PDF Content Search MCP 做什麼？

全文 PDF 搜尋 — 請你的助理在所有已建立索引的 PDF 中搜尋，並回傳相符的文件，附上頁碼與醒目提示的片段。
掃描文件 OCR 搜尋 — 在透過 Apple Vision OCR 轉為可搜尋的掃描 PDF 中尋找文字。
篩選式文件查詢 — 依日期、類別、寄件者或金額縮小搜尋範圍，並可使用布林運算子與萬用字元。
工作階段感知的工具探索 — 伺服器會在 initialize 之後透過 tools/list 公告其可用工具，讓你的用戶端能看到應用程式所公開的功能。

文件

PDF 內容搜尋 MCP 伺服器

為 Claude、Cursor 及任何 MCP 用戶端提供的 PDF 全文搜尋 + OCR。

這是 PDF Content Search 的官方 Model Context Protocol 橋接器——一款原生 macOS 應用程式，可為數千份 PDF（包括透過 Apple Vision OCR 處理的掃描檔）建立索引，並在不到一秒內找到任何內容。

您需要安裝並執行 PDF Content Search 應用程式。 此 MCP 伺服器是 stdio→HTTP 橋接器——索引、OCR 引擎與搜尋功能都位於應用程式內。請至 store.juergenkoller.software/apps/pdf-content-search 取得 PDF Content Search。

您可以做什麼

「Claude，在我所有的 PDF 中找出 2024 年來自 Telekom 的每一張發票，並列出金額 + 日期。」

「Cursor，在我的合約資料夾中搜尋『資料處理協議』，回傳符合的 PDF + 頁碼。」

應用程式透過 MCP 提供搜尋、篩選、OCR、索引及文件中介資料工具。搜尋結果包含頁碼、醒目提示的片段，以及來自 OCR 的邊界框座標。完整工具清單會在 initialize 之後由伺服器於 tools/list 公布。

安裝

先決條件

macOS 12 (Monterey) 或更新版本
已安裝並執行 PDF Content Search 應用程式——在此取得（一次性購買 €89.99，30 天免費試用，內含免費的 iOS + Android 掃描器伴侶應用程式）
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 Content Search → Settings → API Server 取得 PDF_CS_TOKEN，或使用應用程式內的「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 權杖相符的 Bearer 權杖（必填）
`PDF_CS_PORT`	`44477`	應用程式 API 伺服器的連接埠
`PDF_CS_HOST`	`127.0.0.1`	用於連線至應用程式的主機

通訊協定行為

在 stdin/stdout 上使用以換行分隔的 JSON（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 同步及搜尋引擎。此橋接器讓 stdio MCP 傳輸維持開放原始碼，以便您獨立稽核其線路格式。

關於 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
專為辦公室、律師事務所、會計師打造——任何擁有大量文件的人

→ 至 store.juergenkoller.software 取得 PDF Content Search

授權

MIT——請參閱 LICENSE。橋接器為開放原始碼；PDF Content Search 應用程式為商業軟體。

問題與支援

橋接器錯誤：開啟問題
應用程式支援：support@juergenkoller.software

由 Juergen Koller Software GmbH 打造。