LLM’ye veya AI ajanına belgelerden veri çıkarmasını isteyebilir ve yanıtın yapıştırılmış bir dosyanın model tarafından okunmasından değil, bir belge motorundan gelmesini sağlayabilirsiniz. GroupDocs.Parser.Mcp sunucusu yerel olarak bir Docker konteynerinde çalışırken, tek bir istem bir metin, bir tablo, gömülü görüntüler veya bir barkod değeri döndürür:

invoice.pdf ne diyor ve tablosunda ne var?

Adım adım yapılandırma ve sorun giderme sürümü belgelerde bulunabilir: AI ajanlarıyla MCP kullanarak belge verilerini nasıl çıkarılır.

Bir AI ajanının bir çıkarım aracına ihtiyacı neden var?

Bir sohbet modeli yalnızca bağlam penceresine yerleştirilenleri bilir. Bir PDF’yi sohbete yapıştırdığınızda model, istemcinin dosyadan çıkarmayı başarabildiği metin üzerinden çalışır; bu yüzden sütunlar çökebilir, taramalar boş gelebilir ve hangisinin gerçekleştiği anlaşılmaz. Bir çıkarım sunucusu bu adımı modelden ayırır: ajan bir aracı çağırır, bir belge motoru dosyayı konteyner içinde okur ve ajan sonucu alır. Model daha sonra eline geçen değerler üzerinde akıl yürütme yaparak iyi olduğu işi yapar.

GroupDocs.Parser.Mcp, Claude Desktop, Claude Code, Cursor, GitHub Copilot ile VS Code ve Windsurf gibi MCP‑uyumlu istemcilere yedi araç sunar. Beşi veri çıkarır (extract_text, extract_tables, extract_images, extract_barcodes, extract_metadata), biri denetler (get_document_info) ve biri lisans durumunu raporlar (get_license_status).

Yöntem 1: Değeri sor ve ajanın aracı seçmesine izin ver

İsteği belgeyle ilgili bir soru olarak ifade edin. Ajan soruyu bir araca eşler.

İstediğiniz Ajanın çağırdığı araç
“Ne diyor?” extract_text
“Tabloda ne var?” extract_tables
“Kim yazdı ve ne zaman?” extract_metadata
“Şekilleri kaydet.” extract_images
“Barkod neyi kodluyor?” extract_barcodes

extract_text PDF, DOCX, XLSX, PPTX, TXT, HTML, CSV, EML, MSG, RTF, ODT, EPUB ve 50’den fazla ek formatı destekler; bu sayede aynı istem bir e-posta ve bir elektronik tablo üzerinde çalışır. Çok büyük çıktılar bir işaretçiyle kesilir; bu yüzden uzun bir rapor için sayfa sayfa isteyin:

Bu 40 sayfalık raporun metnini sayfa sayfa çıkar ve her bölümü özetle.

Örnek oturum (kısaltılmış):

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.

Yöntem 2: Boş bir sonuç güvenmeden önce metin katmanını kontrol edin

Doğrudan dijital bir PDF bir metin katmanı taşır; bir tarama taşımaz. Tarama yapılan bir sayfada extract_text çok az ya da hiç şey döndürmez; bu dosya hakkında doğru bir ifadedir. Ajana çıkarmadan önce bunu test ettirin:

Kaç sayfa ve çıkarılabilir metin var mı?

get_document_info dosya adını, tipini, sayfa sayısını ve boyutunu hiçbir şeyi değiştirmeden döndürür; tek sayfalık bir extract_text çağrısı metnin var olup olmadığını gösterir. İki ucuz çağrı “bu dosya boş” ile “bu dosya bir görüntü” arasını ayırır. Bu sunucuda OCR adımı yoktur, bu yüzden taramadaki basılı kelimeler piksel olarak kalır. Kodlar istisna oluşturur ve Yöntem 3 bunları kapsar.

Yöntem 3: Metin çıkarımının ulaşamadığını ortaya çıkarın

Tablolar, görüntüler ve barkodlar her biri özel bir araca sahiptir; çünkü bunları metne dönüştürmek, faydalı kılan bilgiyi kaybettirir.

  • extract_tables sohbet içinde render edilen Markdown tabloları döndürür veya format: "json" gönderildiğinde JSON satırları verir.
  • extract_images gömülü her görüntüyü <basename>_image<N>.<ext> biçiminde çıktı klasörüne kaydeder.
  • extract_barcodes Code128, QR Code, PDF417, DataMatrix, EAN-13, EAN-8, UPC, Aztec ve daha fazlasını, tarama sayfalarında bile, motorun modelleri raster görüntüde kodları algıladığı için çözer.

invoice.pdf dosyasındaki satır öğelerini JSON olarak çıkar, ardından 1. sayfadaki görüntüleri kaydet.

Ajanın çıkarım mı yoksa dönüşüm mü ihtiyacı var?

Bunlar farklı görevlerdir ve yanlış sunucuyu seçmek bir karışıklık turuna yol açar.

İstediğiniz Sunucu
Bir belgeden değerler: metin, tablo, barkod, özellikler GroupDocs.Parser.Mcp
Belgeyi başka bir formatta, düzeni korunmuş şekilde GroupDocs.Conversion.Mcp
RAG için tüm belgenin temiz Markdown’u GroupDocs.Markdown.Mcp
Metaveri düzenlenmiş veya kaldırılmış, sadece okunmuş değil GroupDocs.Metadata.Mcp

Birçok işlem hattı iki sunucu kullanır: alım için dönüştür, çıkarım için ayrıştır.

Docker ile yerel olarak çalıştırın

Bu sunucu yalnızca bir Docker görüntüsü olarak sunulur. Motor, yaklaşık 234 MB ONNX modeli içerir; bu da bir NuGet paketini 250 MB sınırının üzerine çıkarır, bu yüzden dnx komutu yoktur. Belgeler klasörünü /data olarak bağlayın:

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

AI istemciniz konteyneri stdio üzerinden bir alt süreç olarak başlatır. Gelen bağlantı noktası yoktur ve belgeler makinede kalır. Claude Desktop, Claude Code, VS Code, Cursor, Windsurf, Cline ve Codex için istemci bazlı yapılandırma AI istemcilerinde kaydolun bölümünde bulunur.

Sınırlamalar nelerdir?

  • Değerlendirme modu. Lisans olmadan çıkarım sınırlıdır; kesin sınırlamalar kütüphanenin lisans sayfasında yer alır. Ajana önce get_license_status çalıştırmasını söyleyin ve lisanssız çıktıyı tam bir okuma yerine bir duman testi olarak değerlendirin.
  • OCR yok. Tarama üzerindeki metin çıkarılamaz.
  • Yalnızca Docker. Docker kurulu olmalı; görüntü büyük olduğundan bir kez çekmeniz yeterlidir.

SSS

Claude ile yerel olarak bir PDF’den metin çıkarabilir miyim, yüklemeden?
Evet. Sunucu makinenizde bir konteyner içinde çalışır ve Claude Desktop stdio üzerinden ona bağlanır; dosya bağlanan klasörden okunur ve bir çıkarım hizmetine gönderilmez.

Ajan bazı PDF’lerde neden hiçbir şey döndürmüyor?
Dosya muhtemelen metin katmanı olmayan bir taramadır. Ajana get_document_info ve tek sayfalık bir extract_text çağrısı yaptırarak doğrulayın, ardından kodlar için extract_barcodes ya da kelimeler için bir OCR aracı kullanın.

GroupDocs.Parser.Mcp için bir dnx komutu var mı?
Hayır. Bu ürün yalnızca Docker ile sunulur; bu yüzden her kurulum docker run ya da Docker başlatan bir MCP istemci girişi kullanır.

Daha derine inin