内容
# PDF 内容搜索 MCP 服务器
[](https://swift.org)
[](https://apple.com/macos)
[](LICENSE)
[](https://modelcontextprotocol.io)
[](https://glama.ai/mcp/servers/juergenkoller-software/pdf-content-search-mcp)
**为 Claude、Cursor 和任何 MCP 客户端提供全文 PDF 搜索 + OCR 功能。**
这是一个官方的 [模型上下文协议](https://modelcontextprotocol.io) 桥接器，用于 [**PDF 内容搜索**](https://store.juergenkoller.software/en/apps/pdf-content-search) — 一个原生 macOS 应用程序，可以索引数千个 PDF 文件（包括通过 Apple Vision OCR 扫描的文件），并在不到一秒的时间内找到任何内容。
> **您需要安装并运行 PDF 内容搜索应用程序。** 此 MCP 服务器是一个 stdio→HTTP 桥接器 — 索引、OCR 引擎和搜索功能都运行在应用程序中。在 [store.juergenkoller.software/apps/pdf-content-search](https://store.juergenkoller.software/en/apps/pdf-content-search) 获取 PDF 内容搜索。
---
## 功能
> "Claude，查找 2024 年来自 Telekom 的所有发票，并列出金额和日期。"
>
> "Cursor，在我的合同文件夹中搜索 '数据处理协议'，返回匹配的 PDF 文件和页码。"
该应用程序通过 MCP 公开搜索、过滤、OCR、索引和文档元数据工具。搜索结果包括页码、突出显示的片段和 OCR 的边界框坐标。在 `tools/list` 初始化后，服务器会宣布完整的工具列表。
---
## 安装
### 先决条件
1. **macOS 12（Monterey）或更高版本**
2. **已安装并运行 PDF 内容搜索应用程序** — [在此处获取](https://store.juergenkoller.software/en/apps/pdf-content-search) （一次性购买 €89.99，30 天免费试用，包括免费的 iOS + Android 扫描器配套应用程序）
3. **Swift 5.9+** （Xcode 15+），如果从源代码构建
### 从源代码构建
```bash
git clone https://github.com/juergenkoller-software/pdf-content-search-mcp.git
cd pdf-content-search-mcp
swift build -c release
# 二进制文件：.build/release/pdf-content-search-mcp
```
通用二进制文件（用于在应用程序包中分发）：
```bash
swift build -c release --arch arm64 --arch x86_64
```
### 应用程序中已包含
如果您已安装 PDF 内容搜索，桥接器将包含在应用程序包的 `Contents/Resources/pdf-content-search-mcp` 中。使用应用程序中的 "**设置 Claude Desktop**" 按钮，自动配置 Claude Desktop 使用正确的路径和令牌 — 这是最终用户的推荐路径。
此存储库是该捆绑桥接器的 **源代码**，保持开放状态，以便您可以审核、 fork 或在其自己的沙盒中运行。
---
## 配置
### Claude Desktop
```json
{
"mcpServers": {
"pdf-content-search": {
"command": "/path/to/pdf-content-search-mcp",
"env": {
"PDF_CS_TOKEN": "your-token-here",
"PDF_CS_PORT": "44477"
}
}
}
}
```
从 **PDF 内容搜索 → 设置 → API 服务器** 获取 `PDF_CS_TOKEN`，或使用应用程序中的 "设置 Claude Desktop" 按钮。
### Claude 代码
```bash
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 服务器令牌匹配的 Bearer 令牌（必需） |
| `PDF_CS_PORT` | `44477` | 应用程序的 API 服务器端口 |
| `PDF_CS_HOST` | `127.0.0.1` | 访问应用程序的宿主 |
---
## 协议行为
- 在 stdin/stdout 上使用换行分隔的 JSON（MCP stdio 传输）。
- 每一行都被原样发送到应用程序的 `/mcp` 端点。
- 缓存第一个响应的 `Mcp-Session-Id` 头部，并将其发送到后续每个请求中，以便在消息之间保持会话状态。
- 通知（无 `id` 的请求）期望 HTTP 202 且不产生 stdout。
- 传输错误被转换为 JSON-RPC 错误响应（代码 `-32000` "无法访问 PDF 内容搜索"），以便客户端显示有意义的消息而不是挂起。
- HTTP 401 → JSON-RPC 错误 `-32001`，并提示重新运行设置。
- 已建立会话的 HTTP 404 会丢弃缓存的 ID，并告诉客户端重新初始化。
---
## 工作原理
```
┌────────────────┐ JSON-RPC stdio ┌────────────────┐ HTTP+Bearer ┌────────────────────┐
│ Claude/Cursor │ ───────────────► │ pdfcs-mcp │ ─────────────► │ PDF 内容搜索 │
│ （MCP 客户端） │ ◄─────────────── │ （此存储库） │ ◄───────────── │ （端口 44477） │
└────────────────┘ └────────────────┘ └────────────────────┘
```
PDF 内容搜索拥有索引（全文 + OCR + 提取的元数据）、AI 命名管道、iOS/Android 同步和搜索引擎。此桥接器保持 stdio MCP 传输的开放源代码，以便您可以独立审核线格式。
---
## 关于 PDF 内容搜索
PDF 内容搜索用闪电般快速的全文搜索取代了复杂的文件夹结构。亮点：
- **一次性购买** — €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 内容搜索](https://store.juergenkoller.software/en/apps/pdf-content-search)**
---
## 许可证
MIT — 请参阅 [LICENSE](LICENSE)。桥接器开源；PDF 内容搜索应用程序是商业软件。
## 问题和支持
- **桥接器错误：** [打开问题](https://github.com/juergenkoller-software/pdf-content-search-mcp/issues)
- **应用程序支持：** [support@juergenkoller.software](mailto:support@juergenkoller.software)
由 [Juergen Koller Software GmbH](https://juergenkoller.software) 构建。
