Pdf Content Search Mcp

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，在我的合同文件夹中搜索 ‘data processing agreement’，返回匹配的 PDF 和页码。”

应用通过 MCP 提供搜索、筛选、OCR、索引和文档元数据工具。搜索结果包含页码、高亮片段，以及 OCR 生成的边界框坐标。服务器会在 initialize 后通过 tools/list 公布完整工具列表。

---

安装

前置条件

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 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	(none)	与应用 API Server 令牌匹配的 Bearer token（必需）
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 应用为商业软件。

问题与支持

• 桥接工具问题：提交问题
• 应用支持：[email protected]

由 Juergen Koller Software GmbH 构建。