PDF Content Search MCP

เซิร์ฟเวอร์ MCP สำหรับค้นหาเนื้อหาใน PDF

ค้นหาข้อความเต็มใน PDF + OCR สำหรับ Claude, Cursor และไคลเอนต์ MCP ใด ๆ

นี่คือบริดจ์ Model Context Protocol อย่างเป็นทางการสำหรับ PDF Content Search — แอป macOS แบบเนทีฟที่จัดทำดัชนี PDF หลายพันไฟล์ (รวมถึงไฟล์สแกนผ่าน Apple Vision OCR) และค้นหาสิ่งใดก็ได้ภายในเวลาไม่ถึงหนึ่งวินาที

คุณต้องติดตั้งและเปิดแอป PDF Content Search ไว้ เซิร์ฟเวอร์ MCP นี้เป็นบริดจ์แบบ stdio→HTTP — ดัชนี เอนจิน OCR และการค้นหาทำงานอยู่ในแอป ดาวน์โหลด PDF Content Search ได้ที่ store.juergenkoller.software/apps/pdf-content-search

---

สิ่งที่คุณทำได้

"Claude ช่วยหาใบแจ้งหนี้ทั้งหมดจาก Telekom ในปี 2024 จาก PDF ทั้งหมดของฉัน แล้วแสดงจำนวนเงิน + วันที่"

"Cursor ช่วยค้นหา 'ข้อตกลงการประมวลผลข้อมูล' ในโฟลเดอร์สัญญาของฉัน แล้วคืนค่า PDF ที่ตรงกัน + หมายเลขหน้า"

แอปเปิดเผยเครื่องมือสำหรับการค้นหา การกรอง OCR การจัดทำดัชนี และข้อมูลเมตาของเอกสารผ่าน MCP ผลการค้นหาประกอบด้วยหมายเลขหน้า ข้อความที่ไฮไลต์ และพิกัดกรอบล้อม (bounding-box) จาก OCR รายการเครื่องมือทั้งหมดจะถูกประกาศโดยเซิร์ฟเวอร์บน tools/list หลังจาก initialize

---

การติดตั้ง

ข้อกำหนดเบื้องต้น

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

ไบนารีแบบ Universal (สำหรับจัดส่งภายในบันเดิลของแอป):

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 อื่น ๆ

รูปแบบเดียวกัน — เซิร์ฟเวอร์ MCP แบบ stdio

---

ตัวแปรสภาพแวดล้อม

ตัวแปร	ค่าเริ่มต้น	คำอธิบาย
PDF_CS_TOKEN	(ไม่มี)	โทเคน Bearer ที่ตรงกับโทเคน API Server ของแอป (จำเป็น)
PDF_CS_PORT	44477	พอร์ตของ API server ของแอป
PDF_CS_HOST	127.0.0.1	โฮสต์สำหรับเข้าถึงแอป

---

พฤติกรรมของโปรโตคอล

• JSON แบบคั่นด้วยบรรทัดใหม่บน stdin/stdout (การรับส่ง 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 และเอนจินค้นหา บริดจ์นี้เปิดเผยการรับส่ง MCP แบบ stdio เป็นโอเพนซอร์สเพื่อให้คุณตรวจสอบรูปแบบการรับส่งข้อมูลได้อย่างอิสระ

---

เกี่ยวกับ 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
• สร้างมาเพื่อสำนักงาน สำนักงานกฎหมาย และนักบัญชี — ใครก็ตามที่มีเอกสารจำนวนมาก

→ ดาวน์โหลด PDF Content Search ได้ที่ store.juergenkoller.software

---

สัญญาอนุญาต

MIT — ดู LICENSE บริดจ์เป็นโอเพนซอร์ส ส่วนแอป PDF Content Search เป็นซอฟต์แวร์เชิงพาณิชย์

ปัญหาและการสนับสนุน

• บั๊กของบริดจ์: เปิด issue
• การสนับสนุนแอป: support@juergenkoller.software

สร้างโดย Juergen Koller Software GmbH