Platform Takımları GroupDocs.Parser’ı .NET Üzerinde MCP İstemcilerine Belge Araçlarını Bağlamak İçin Nasıl Kullanıyor
💡 Tam çalışan örnek GitHub’da mevcuttur: parser-mcp-document-tools-dotnet
Platform Zorluğu: Belge Araçları MCP Sınırlarında Neden Duraklıyor
Docker destekli belge araçları, MCP istemcileri için .NET üzerinde bir GroupDocs.Parser.Mcp dağıtım modelidir; bu model bir konteyner imajını get_document_info, extract_text ve extract_tables için çevrim dışı kütüphane kontrolleriyle eşleştirir. Asistanlar için belge araçları sunan platform mühendislik grupları nadiren “DOCX’i ayrıştırabilir miyiz?” sorusuyla mücadele eder. Daha keskin bir sorunla karşılaşırlar: MCP sunucusu, istemci yapılandırmalarında adlandırılmış bir araç listesi olarak görünmelidir, ancak ayrıştırma motoru o kadar büyüktür ki GroupDocs.Parser.Mcp yalnızca bir konteyner imajı olarak dağıtılır, NuGet paketi olarak değil.
Bir ürün ekibi MCP istemcisi içinde belge bilgisi, düz metin ve sohbet‑hazır tablolar istediğinde, platform takımı iki yolu aynı anda yürütmek zorundadır. Birinci yol operasyonlardır: /data konumunda bir hacimle docker run, :26.9.0 gibi sabit etiketler ve kararlı bir mcpServers girdisi. İkinci yol doğrulamadır: GroupDocs.Parser for .NET’in, canlı bir el sıkışma gerçekleşmeden önce bu araçların döndüreceği aynı gerçekleri sağladığını kanıtlamak. Bu iki yoldan biri eksik kalırsa, hatalar boş MCP istemci yanıtları olarak ortaya çıkar; birim testi başarısızlığı olarak değil.
Bu takımların ihtiyacı nettir: MCP istemcilerine yapıştırabilecekleri bir kayıt snippet’i ve JSON, metin ve Markdown artefaktları üreten çevrim dışı C# çağrıları. Bunu, bir ortak Docker geliştirici dizüstü bilgisayarlarda onaylanmadan önce sohbet içinde extract_tables istediğinde deneyimledim – kütüphane aynaları, güvenlik konteyner incelemesini tamamlarken teslimatı sürdürdü.
Industry snapshot: GroupDocs.Parser.Mcp şu adreste yayınlanmaktadır
ghcr.io/groupdocs-parser/parser-net-mcpve motorun NuGet boyut sınırlarını aşması nedeniyle yalnızca Docker‑only dağıtımını belgelemektedir. Yerel demolar, canlı bir MCP oturumu gerektirmeden araç‑eşdeğer API’leri doğrular (MCP docs).
Genel Yaklaşımların Burada Neden Yetersiz Kaldığı
Takımlar, özel bir MCP belge sunucusu benimsemeden önce genellikle şu yolları dener:
- Masaüstü dönüştürücüler etrafında ad‑hoc kabuk betikleri: DOCX ve XLSX arasında kırılgandır ve adlandırılmış MCP araçlarını sunmaz.
- Parser’ı yalnızca özel bir API içinde çağırmak: İşlem içinde çalışır, ancak MCP istemcileri
get_document_infoya daextract_textgibi birinci sınıf araçları hiç görmez. - Bir NuGet MCP paketi beklemek: Bu sunucu için mevcut değildir; yayınlanan yol konteyner imajıdır.
GroupDocs.Parser, Docker MCP sunucusunu .NET servislerinizin zaten kullandığı aynı Parser API’larıyla eşleştirerek boşluğu doldurur.
Çözüm: Platform MCP İş Akışında GroupDocs.Parser
GroupDocs.Parser for .NET, MCP hikayesinin doğrulama yarısını oluşturur.
Parser.GetDocumentInfo, Parser.GetText, GetFormattedText(Markdown) ve GetTables araçlarını, GroupDocs.Parser.Mcp’nin MCP istemcilerine sunduğu araçları yansıtır. Örnek depolama, kayıt için Result/mcp-server.example.json yazar, ardından paketlenmiş DOCX ve XLSX dosyalarına karşı en çok kullanılan üç aracı çalıştırır; böylece operatörler çıktıları Result/ altında inceleyebilir.
Aşağıdaki uygulamayı takip etmek için şunlara ihtiyacınız olacak:
- .NET 8 SDK
- GroupDocs.Parser 26.10.0
(temporary license) - Örnek belgeler (depo
sample.docx,sample.xlsx,sample.pdfiçerir) - Canlı MCP sunucusunu başlatırken yalnızca Docker Engine
dotnet add package GroupDocs.Parser --version 26.10.0
MCP Belge Araçlarını Adım Adım Uygulama
GroupDocs.Parser.Mcp’yi kaydetme ve araç‑eşdeğer API’leri doğrulama şekli aşağıdadır. Senaryo, .NET 8 üzerinde asistanlar için belge araçları getiren bir platform ekibine uygundur.
Adım 1 - Docker MCP kaydını oluşturun
mcpServers girdisini, konteyneri etkileşimli olarak çalıştıran ve ana bilgisayar belge klasörünü /data altında bağlayan bir giriş olarak yazın. Paylaşılan yapılandırmalarda etiketleri sabitleyin.
// JSON for MCP clients: docker run --rm -i -v <host>:/data <image>
string normalizedHost = hostDocumentsPath.Replace('\\', '/');
var payload = new
{
mcpServers = new
{
groupdocs_parser = new
{
command = "docker",
args = new[]
{
"run", "--rm", "-i",
"-v", $"{normalizedHost}:/data",
McpImage
}
}
},
Araç listesini ekleyin ve istemci içe aktarımı için UTF‑8 JSON yazın:
tools = new[]
{
"extract_text",
"extract_tables",
"extract_metadata",
"extract_images",
"extract_barcodes",
"get_document_info",
"get_license_status"
},
notes = "Pin the image tag in shared configs "
+ "(for example :26.9.0) instead of :latest."
};
var json = JsonSerializer.Serialize(
payload,
new JsonSerializerOptions { WriteIndented = true });
File.WriteAllText(outputPath, json, Encoding.UTF8);
Adım 2 - get_document_info‘u ön uç kontrolü için yansıtın
MCP istemcileri genellikle daha ağır araçları çağırmadan önce get_document_info‘u çalıştırır. Şemaların stabil kalması için bu sözleşmeyi Parser.GetDocumentInfo ile yansıtın.
using var parser = new Parser(sourcePath);
var info = parser.GetDocumentInfo();
var payload = new
{
fileName = Path.GetFileName(sourcePath),
fileType = info?.FileType?.ToString(),
pageCount = info?.PageCount,
sizeBytes = info?.Size
};
File.WriteAllText(
outputPath,
JsonSerializer.Serialize(
payload,
new JsonSerializerOptions { WriteIndented = true }),
Encoding.UTF8);
Bu alanların platform operasyonları için neden önemli olduğu:
fileType: Metin araçları çalıştırılmadan önce ayrıştırıcının formatı tanıdığını doğrularpageCount: MCP istemci bağlam bütçelerini boyutlandırmak için ucuz bir sinyalsizeBytes: Gelen yüklemeler için kota ve anomali kontrollerini destekler
Paketlenmiş sample.docx üzerinde, kaydedilen çalışma Microsoft Word Open XML tipi, 2 sayfa ve 15214 bayt rapor eder.
Adım 3 - extract_text‘i asistan‑okunabilir çıktı için yansıtın
using var parser = new Parser(sourcePath);
using TextReader? reader = parser.GetText();
if (reader == null)
{
File.WriteAllText(outputPath, string.Empty, Encoding.UTF8);
return 0;
}
string text = reader.ReadToEnd();
File.WriteAllText(outputPath, text, Encoding.UTF8);
return text.Length;
Karakter sayısını döndürmek, CI ve konsollara, operatörlerin MCP extract_text aracından beklediği ölçülebilir bir başarı sinyali verir.
Adım 4 - extract_tables‘ı sohbet UI’ları için Markdown olarak yansıtın
Öncelikle biçimlendirilmiş Markdown tercih edin, ardından GetTables‘dan boru (pipe) tablolarına geri dönün; böylece sohbet istemcileri tutarlı bir render yolu elde eder.
using var parser = new Parser(sourcePath);
using (TextReader? formatted = parser.GetFormattedText(
new FormattedTextOptions(FormattedTextMode.Markdown)))
{
if (formatted != null)
{
string markdown = formatted.ReadToEnd();
File.WriteAllText(outputPath, markdown, Encoding.UTF8);
int rows = 0;
using var sr = new StringReader(markdown);
string? line;
while ((line = sr.ReadLine()) != null)
{
if (line.Contains('|', StringComparison.Ordinal))
rows++;
}
return rows > 0
? rows
: (string.IsNullOrWhiteSpace(markdown) ? 0 : 1);
}
}
Biçimlendirilmiş Markdown mevcut değilse, özellikleri ve yapısal tabloları kontrol edin:
if (!parser.Features.Tables)
{
File.WriteAllText(
outputPath,
"_Tables extraction is not supported for this file._\n",
Encoding.UTF8);
return 0;
}
IEnumerable<PageTableArea>? tables = parser.GetTables();
if (tables == null)
{
File.WriteAllText(outputPath, "_No tables returned._\n", Encoding.UTF8);
return 0;
}
Aşağı akış sistemleri, Markdown’ı kaynak XLSX’in yanına arşivleyebilir veya ikinci bir dönüştürücüye ihtiyaç duymadan boru tablolarını doğrudan MCP istemci sohbet bölmelerine besleyebilir.
Platform takımlarının hem Docker MCP hem de kütüphane aynalarını neden tutması gerekir?
MCP istemcileri /data altındaki dosyalara ghcr.io/groupdocs-parser/parser-net-mcp üzerinden adlandırılmış araçlarla erişmesi gerektiğinde Docker MCP’yi tutun. PR’ların, canlı bir el sıkışma olmadan get_document_info, extract_text ve extract_tables‘ı kanıtlaması gerektiğinde kütüphane aynalarını tutun. Bu çift yol, konteyner politikası ile ayrıştırma gerilemelerini ayırır. Üretim etiketini sabitleyin ve örnek repo gösterdiği gibi her Parser paketi yükseltmesinde .NET aynalarını CI’de çalıştırın.
Gerçek İş Akışı: Paylaşılan MCP İstemci Filosu İçin Belge Araçlarını Yönlendirme
Üç ürün ekibini destekleyen bir platform takımı, tek bir MCP istemci temelini sürdürür. Her ekip, ortak bir belge hacmine DOCX politikaları ve XLSX oran tabloları bırakır. Yeni bir parser-net-mcp etiketi yayınlamadan önce ekip, .NET konsol ana bilgisayarını çalıştırır: kayıt JSON’u yeniden oluşturulur, document-info.json altın değerlerle (duman DOCX için 2 sayfa / 15214 bayt) karşılaştırılır, metin karakter sayıları kaydedilir ve XLSX örneğinden Sheet1/Sheet2 Markdown’ı boru‑tablo yapısı için incelenir.
Bu iş akışı doğrudan yukarıdaki adımlara eşlenir. Adım 1 filo yapılandırmasıdır. Adım 2‑4 çevrim dışı kapılardır. Bu kapılar geçtikten sonra sabitlenmiş konteyner imajı MCP istemci makinelerine dağıtılır. Docker‑özel hatalar için operatörler
MCP troubleshooting guide adresini kullanır.
İş Etkisi: Bu Değişiklik Ne Sağlıyor
| Ölçüt | Önce (ad‑hoc) | Sonra (GroupDocs.Parser + MCP) |
|---|---|---|
| İstemci kaydı | Manuel notlar, dizüstü bilgisayarlara göre kayma | mcpServers JSON’ı sürüm kontrolüne alınmış |
| Araç sözleşme kontrolleri | Canlı MCP çağrıları başarısız olduktan sonra | Çevrim dışı JSON/metin/Markdown fixture’ları |
| Sohbete tablo teslimi | Özel CSV dönüştürücüler | extract_tables ile uyumlu Markdown |
| Paket dağıtımı | NuGet MCP beklentisi | Açıkça Docker‑only sunucu + NuGet kütüphanesi |
| İmaj kayması | Yüzen :latest |
:26.9.0 gibi sabit etiketler |
| Denetim izi | Yalnızca sohbet kayıtları | Çalışma başına Result/ artefaktları |
Bileşik etki, MCP istemcileri için daha hızlı onboarding ve konteyner politikası ile ayrıştırma davranışı farklı takvimlerde ilerlediğinde üretim sürprizlerinin azalmasıdır.
Bu Yaklaşımın Uygun Olduğu Diğer Platform Senaryoları
Kayıt ve aynalar kurulduktan sonra aynı API’lar şunları destekler:
- Ön‑yükleme kapıları:
pageCountveyasizeBytespolitika dışı olduğunda MCP istemcileri çalışmadan yüklemeleri reddet - Elektronik tablo özetleri: XLSX’ten Markdown tablolarını stand‑up botlarına gönder
- Çok‑formatlı duman paketleri: DOCX, XLSX ve PDF örneklerini haftalık gerileme testleri için MCP yapılandırmasının yanına tut
- Yan araç dağıtımları: GroupDocs.Parser.Mcp’yi hâlâ iç süreç Parser kullanan bir .NET API’nin yanında çalıştır
Platform Ortamınızda Başlamak
GroupDocs.Parser’ın .NET üzerindeki platform takımları için MCP belge araçlarını nasıl yönettiğini gördünüz. Sonraki adımlar:
- Ücretsiz başlayın: Geçici bir lisans alın
- MCP kurulumunu okuyun: GroupDocs.Parser MCP belgeleri
- Kullanım senaryosunu izleyin: MCP üzerinden belgeleri ayrıştırın
- Örnekleri inceleyin: GroupDocs.Parser for .NET örnekleri
- Sorularınızı sorun: Parser forumu