PDF Content Search MCP

Máy chủ MCP Tìm kiếm Nội dung PDF

Tìm kiếm toàn văn PDF + OCR cho Claude, Cursor và mọi ứng dụng khách MCP.

Đây là cầu nối chính thức của Model Context Protocol cho PDF Content Search — một ứng dụng gốc macOS lập chỉ mục hàng nghìn tệp PDF (bao gồm cả bản quét qua Apple Vision OCR) và tìm thấy mọi thứ trong chưa đầy một giây.

Bạn cần cài đặt và chạy ứng dụng PDF Content Search. Máy chủ MCP này là cầu nối stdio→HTTP — chỉ mục, công cụ OCR và tìm kiếm đều nằm trong ứng dụng. Tải PDF Content Search tại store.juergenkoller.software/apps/pdf-content-search.

---

Những gì bạn có thể làm

"Claude, tìm mọi hóa đơn từ Telekom trong năm 2024 trên tất cả tệp PDF của tôi và liệt kê số tiền + ngày."

"Cursor, tìm 'thỏa thuận xử lý dữ liệu' trong thư mục hợp đồng của tôi, trả về tệp PDF khớp + số trang."

Ứng dụng cung cấp các công cụ tìm kiếm, lọc, OCR, lập chỉ mục và siêu dữ liệu tài liệu thông qua MCP. Kết quả tìm kiếm bao gồm số trang, đoạn trích được đánh dấu và tọa độ hộp giới hạn từ OCR. Danh sách công cụ đầy đủ được máy chủ công bố trên tools/list sau initialize.

---

Cài đặt

Điều kiện tiên quyết

1. macOS 12 (Monterey) trở lên
2. Ứng dụng PDF Content Search đã cài đặt và đang chạy — tải tại đây (mua một lần €89.99, dùng thử miễn phí 30 ngày, bao gồm ứng dụng quét đồng hành miễn phí cho iOS + Android)
3. Swift 5.9+ (Xcode 15+) nếu xây dựng từ mã nguồn

Xây dựng từ mã nguồn

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

Gói nhị phân phổ quát (để đóng gói bên trong gói ứng dụng):

swift build -c release --arch arm64 --arch x86_64

Đã có sẵn trong ứng dụng

Nếu bạn đã cài đặt PDF Content Search, cầu nối được đóng gói sẵn trong gói ứng dụng tại Contents/Resources/pdf-content-search-mcp. Sử dụng nút "Set up Claude Desktop" trong ứng dụng để tự động cấu hình Claude Desktop với đường dẫn và mã thông báo chính xác — đó là cách được khuyến nghị cho người dùng cuối.

Kho lưu trữ này là mã nguồn của cầu nối được đóng gói đó, được giữ mở để bạn có thể kiểm tra, tạo bản sao hoặc chạy nó trong môi trường sandbox riêng của bạn.

---

Cấu hình

Claude Desktop

{
  "mcpServers": {
    "pdf-content-search": {
      "command": "/path/to/pdf-content-search-mcp",
      "env": {
        "PDF_CS_TOKEN": "your-token-here",
        "PDF_CS_PORT": "44477"
      }
    }
  }
}

Lấy PDF_CS_TOKEN từ PDF Content Search → Settings → API Server, hoặc sử dụng nút "Set up Claude Desktop" trong ứng dụng.

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 / các ứng dụng khách MCP khác

Cùng một mẫu — máy chủ MCP stdio.

---

Biến môi trường

Biến	Mặc định	Mô tả
PDF_CS_TOKEN	(không có)	Mã thông báo Bearer khớp với mã thông báo API Server của ứng dụng (bắt buộc)
PDF_CS_PORT	44477	Cổng của máy chủ API của ứng dụng
PDF_CS_HOST	127.0.0.1	Máy chủ để kết nối tới ứng dụng

---

Hành vi giao thức

• JSON phân tách bằng dòng mới trên stdin/stdout (truyền tải MCP stdio).
• Mỗi dòng được POST nguyên văn tới điểm cuối /mcp của ứng dụng.
• Tiêu đề Mcp-Session-Id của phản hồi đầu tiên được lưu vào bộ nhớ đệm và gửi kèm mọi yêu cầu tiếp theo, do đó trạng thái phiên được duy trì qua các tin nhắn.
• Các thông báo (yêu cầu không có id) mong đợi HTTP 202 và không tạo ra stdout.
• Lỗi truyền tải được chuyển thành phản hồi lỗi JSON-RPC (mã -32000 "Cannot reach PDF Content Search") để ứng dụng khách hiển thị thông báo có ý nghĩa thay vì bị treo.
• HTTP 401 → lỗi JSON-RPC -32001 kèm gợi ý chạy lại thiết lập.
• HTTP 404 trên một phiên đã thiết lập sẽ xóa ID đã lưu trong bộ nhớ đệm và yêu cầu ứng dụng khách khởi tạo lại.

---

Cách hoạt động

┌────────────────┐  JSON-RPC stdio   ┌────────────────┐  HTTP+Bearer   ┌────────────────────┐
│  Claude/Cursor │ ───────────────►  │ pdfcs-mcp      │ ─────────────► │ PDF Content Search │
│  (MCP client)  │ ◄───────────────  │   (this repo)  │ ◄───────────── │  (port 44477)      │
└────────────────┘                   └────────────────┘                └────────────────────┘

PDF Content Search sở hữu chỉ mục (toàn văn + OCR + siêu dữ liệu được trích xuất), quy trình đặt tên bằng AI, đồng bộ iOS/Android và công cụ tìm kiếm. Cầu nối này giữ mã nguồn mở cho truyền tải MCP stdio để bạn có thể kiểm tra định dạng truyền tải một cách độc lập.

---

Giới thiệu về PDF Content Search

PDF Content Search thay thế cấu trúc thư mục phức tạp bằng tìm kiếm toàn văn nhanh như chớp. Điểm nổi bật:

• Mua một lần — €89.99, không đăng ký
• Tìm kiếm toàn văn trên hàng nghìn tệp PDF trong chưa đầy một giây
• Nhận dạng văn bản OCR — Apple Vision Framework, giúp bản quét có thể tìm kiếm được
• Đặt tên tệp bằng AI — ảnh chụp hóa đơn từ điện thoại trở thành 250401 Invoice Telekom.pdf
• Ứng dụng đồng hành miễn phí — bao gồm ứng dụng quét cho iOS và Android
• Đồng bộ mã hóa tới Mac
• Bộ lọc nâng cao — ngày, danh mục, người gửi, số tiền; toán tử boolean; ký tự đại diện
• Tích hợp Spotlight + iCloud Drive
• Máy chủ MCP (kho lưu trữ này) + REST API
• Dành cho văn phòng, công ty luật, kế toán — bất kỳ ai có nhiều tài liệu

→ Tải PDF Content Search tại store.juergenkoller.software

---

Giấy phép

MIT — xem LICENSE. Cầu nối mã nguồn mở; ứng dụng PDF Content Search là thương mại.

Vấn đề & hỗ trợ

• Lỗi cầu nối: mở một vấn đề
• Hỗ trợ ứng dụng: support@juergenkoller.software

Được xây dựng bởi Juergen Koller Software GmbH.