Pdf Content Search Mcp

PDF Content Search MCP サーバー

Claude、Cursor、あらゆる MCP クライアント向けの、PDF 全文検索と OCR です。

これは、PDF Content Search の公式 Model Context Protocol ブリッジです。数千件の PDF（Apple Vision OCR によるスキャン済み PDF を含む）をインデックス化し、1 秒以内に目的の情報を検索できるネイティブ macOS アプリです。

PDF Content Search アプリをインストールして起動しておく必要があります。 この MCP サーバーは stdio→HTTP ブリッジです。インデックス、OCR エンジン、検索機能はアプリ内にあります。PDF Content Search は store.juergenkoller.software/apps/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_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	(none)	アプリの 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、「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 を 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 アプリは商用製品です。

問題とサポート

• ブリッジのバグ： 問題を報告
• アプリのサポート： [email protected]

Juergen Koller Software GmbH が開発しました。