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 Content Search 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 配置正确的路径和令牌——这是面向最终用户的推荐方式。

此仓库是该内置桥接器的源代码，保持开源，以便你可以审计它、fork 它，或在你自己的沙盒中运行它。

配置

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 应用为商业软件。

问题与支持

桥接器缺陷：提交 issue
应用支持：support@juergenkoller.software

由 Juergen Koller Software GmbH 构建。