Anda dapat meminta LLM atau agen AI untuk mengekstrak data dari dokumen dan mendapatkan jawaban dari mesin dokumen, bukan dari pembacaan model terhadap file yang ditempelkan. Dengan server GroupDocs.Parser.Mcp yang berjalan secara lokal dalam kontainer Docker, satu prompt mengembalikan teks, tabel, gambar tersemat, atau nilai barcode:

Apa yang dikatakan invoice.pdf, dan apa yang ada di tabelnya?

Versi langkah demi langkah dengan konfigurasi dan pemecahan masalah ada di dokumentasi: Cara mengekstrak data dokumen dengan agen AI menggunakan MCP.

Mengapa agen AI memerlukan alat ekstraksi sama sekali?

Model obrolan hanya mengetahui apa yang ditempatkan dalam jendela konteksnya. Menempelkan PDF ke dalam obrolan membuat model bekerja dari teks apa pun yang berhasil di‑flatten oleh klien, sehingga kolom runtuh, hasil pemindaian kosong, dan tidak ada yang dapat memberitahu mana yang terjadi. Server ekstraksi memindahkan langkah itu keluar dari model: agen memanggil sebuah alat, mesin dokumen membaca file di dalam kontainer, dan agen menerima hasilnya. Model kemudian melakukan apa yang paling baik dilakukannya, yaitu menalar atas nilai‑nilai yang diberikan.

GroupDocs.Parser.Mcp mengekspos tujuh alat untuk klien kompatibel MCP seperti Claude Desktop, Claude Code, Cursor, VS Code dengan GitHub Copilot, dan Windsurf. Lima di antaranya mengekstrak data (extract_text, extract_tables, extract_images, extract_barcodes, extract_metadata), satu memeriksa (get_document_info), dan satu melaporkan lisensi (get_license_status).

Cara 1: Minta nilai, dan biarkan agen memilih alat

Ungkapkan permintaan sebagai pertanyaan tentang dokumen. Agen memetakan pertanyaan ke sebuah alat.

Anda menanyakan Alat yang dipanggil agen
“Apa yang dikatakannya?” extract_text
“Apa yang ada di tabel?” extract_tables
“Siapa yang menulisnya, dan kapan?” extract_metadata
“Simpan gambar.” extract_images
“Apa yang dikodekan barcode?” extract_barcodes

extract_text mendukung PDF, DOCX, XLSX, PPTX, TXT, HTML, CSV, EML, MSG, RTF, ODT, EPUB, dan lebih dari 50 format lainnya, sehingga prompt yang sama berfungsi pada email maupun spreadsheet. Output yang sangat besar dipotong dengan penanda, jadi untuk laporan panjang minta per halaman:

Ekstrak teks laporan 40 halaman ini halaman per halaman dan rangkum setiap bagian.

Contoh sesi (disingkat):

You:    What does invoice.pdf say, and what is in its table?
Agent:  [calls extract_text, extract_tables]
        Invoice 2026-0412 from Northwind Supplies, dated 3 October.
        The table has 3 rows (item, quantity, amount); the amounts add up to 1,240.00.

Cara 2: Periksa lapisan teks sebelum mempercayai hasil kosong

PDF yang dibuat secara digital memiliki lapisan teks; pemindaian tidak. Pada halaman yang dipindai extract_text mengembalikan sedikit atau tidak ada apa‑apa, yang merupakan pernyataan yang tepat tentang file tersebut. Buat agen menguji ini sebelum mengekstrak:

Berapa banyak halaman dokumen ini, dan apakah memiliki teks yang dapat diekstrak?

get_document_info mengembalikan nama file, tipe, jumlah halaman, dan ukuran tanpa mengubah apa pun, dan panggilan extract_text satu halaman menunjukkan apakah teks ada. Dua panggilan murah memisahkan “file ini kosong” dari “file ini berupa gambar”. Tidak ada langkah OCR di server ini, sehingga kata‑kata yang tercetak dalam pemindaian tetap berupa piksel. Kode merupakan pengecualian, dan Cara 3 membahasnya.

Cara 3: Tarik apa yang tidak dapat dijangkau oleh ekstraksi teks

Tabel, gambar, dan barcode masing‑masing memiliki alat khusus, karena meratakan mereka menjadi teks akan menghilangkan kegunaannya.

  • extract_tables mengembalikan tabel Markdown yang dapat dirender dalam obrolan, atau baris JSON ketika Anda menyertakan format: "json".
  • extract_images menyimpan setiap gambar tersemat ke folder output sebagai <basename>_image<N>.<ext>.
  • extract_barcodes mendekode Code128, QR Code, PDF417, DataMatrix, EAN-13, EAN-8, UPC, Aztec, dan lainnya, termasuk pada halaman yang dipindai, karena model mesin mendeteksi kode dalam gambar raster.

Ekstrak item baris dari invoice.pdf sebagai JSON, lalu simpan gambar dari halaman 1.

Apakah agen memerlukan ekstraksi atau konversi?

Ini adalah pekerjaan yang berbeda, dan memilih server yang salah menimbulkan kebingungan.

Anda menginginkan Server
Nilai dari dokumen: teks, tabel, barcode, properti GroupDocs.Parser.Mcp
Dokumen dalam format lain, tata letak dipertahankan GroupDocs.Conversion.Mcp
Markdown bersih dari seluruh dokumen untuk RAG GroupDocs.Markdown.Mcp
Metadata yang diedit atau dihapus, bukan hanya dibaca GroupDocs.Metadata.Mcp

Banyak alur kerja menggunakan dua server: konversi untuk ingest, parse untuk ekstraksi.

Jalankan secara lokal dengan Docker

Server ini hanya tersedia sebagai gambar Docker. Mesin menyertakan sekitar 234 MB model ONNX, yang membuat paket NuGet melebihi batas 250 MB, jadi tidak ada perintah dnx. Pasang folder dokumen sebagai /data:

docker run --rm -i -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-parser/parser-net-mcp:latest

Klien AI Anda memulai kontainer sebagai proses anak melalui stdio. Tidak ada port masuk, dan dokumen tetap berada di mesin. Konfigurasi per‑klien untuk Claude Desktop, Claude Code, VS Code, Cursor, Windsurf, Cline, dan Codex ada di Daftar di klien AI.

Apa batasannya?

  • Evaluation mode. Tanpa lisensi, ekstraksi terbatas; batas tepatnya ada di halaman lisensi. Minta agen menjalankan get_license_status terlebih dahulu, dan perlakukan output tanpa lisensi sebagai uji coba, bukan bacaan lengkap.
  • No OCR. Teks dalam pemindaian tidak dapat diekstrak.
  • Docker only. Anda memerlukan Docker terpasang; gambar berukuran besar, jadi tarik sekali saja.

FAQ

Apakah saya dapat mengekstrak teks dari PDF dengan Claude secara lokal, tanpa mengunggahnya?
Ya. Server berjalan dalam kontainer di mesin Anda dan Claude Desktop berkomunikasi dengannya melalui stdio, sehingga file dibaca dari folder yang dipasang dan tidak dikirim ke layanan ekstraksi.

Mengapa agen mengembalikan kosong untuk beberapa PDF?
File tersebut kemungkinan besar merupakan pemindaian tanpa lapisan teks. Minta agen menjalankan get_document_info dan panggilan extract_text satu halaman untuk mengonfirmasi, lalu gunakan extract_barcodes untuk kode atau alat OCR untuk kata‑kata.

Apakah ada perintah dnx untuk GroupDocs.Parser.Mcp?
Tidak. Produk ini hanya tersedia untuk Docker, sehingga setiap instalasi menggunakan docker run atau entri klien MCP yang meluncurkan Docker.

Selami Lebih Dalam