Як команди платформи використовують GroupDocs.Parser для підключення інструментів документів до MCP‑клієнтів на .NET

💡 Повний робочий приклад доступний на GitHub:
parser-mcp-document-tools-dotnet

Виклик платформи: Чому інструменти документів зупиняються на межах MCP

Docker‑базовані інструменти документів для MCP‑клієнтів — це шаблон розгортання GroupDocs.Parser.Mcp на .NET, який поєднує образ контейнера з офлайн‑перевірками бібліотеки для get_document_info, extract_text та extract_tables. Групи інженерії платформи, які постачають інструменти документів для асистентів, рідко стикаються з питанням «чи можемо розпарсити DOCX?». Вони стикаються з більш гострим обмеженням: сервер MCP має з’явитися в конфігураціях клієнта як іменований список інструментів, тоді як парсерний движок настільки великий, що GroupDocs.Parser.Mcp постачається лише як образ контейнера, а не як пакет NuGet.

Коли продуктова команда запитує інформацію про документ, простий текст і таблиці, готові до чату, всередині MCP‑клієнта, команда платформи успадковує два напрямки. Перший — операції: docker run з томом у /data, закріплені теги типу :26.9.0 і стабільний запис mcpServers. Другий — верифікація: довести, що GroupDocs.Parser для .NET повертає ті ж факти, які повернули б інструменти, до того як хтось залежатиме від живого рукостискання. Пропустити будь‑який з напрямків — і помилки проявляються у вигляді порожніх відповідей MCP‑клієнта замість проваленого юніт‑тесту.

Що саме потрібно цим командам: явний фрагмент реєстрації, який вони можуть вставити в MCP‑клієнти, плюс офлайн‑виклики C#, що записують JSON, текст і артефакти Markdown для перегляду. Я зіткнувся з цим, коли партнер попросив extract_tables у чаті ще до того, як Docker був схвалений на ноутбуках розробників — бібліотечні дзеркала підтримували доставку, поки безпека завершувала перевірку контейнера.

Огляд індустрії: GroupDocs.Parser.Mcp опубліковано за адресою
ghcr.io/groupdocs-parser/parser-net-mcp і документує розповсюдження лише через Docker, бо движок перевищує обмеження розміру NuGet. Локальні демо‑версії, отже, перевіряють API, еквівалентні інструментам, без потреби в живій сесії MCP (MCP docs).


Чому типові підходи тут не працюють

Команди зазвичай пробують один із таких шляхів перед впровадженням спеціального серверу документів MCP:

  • Ад‑hoc скрипти оболонки навколо настільних конвертерів: крихкі для DOCX і XLSX, і не представляють іменованих інструментів MCP.
  • Виклик Parser лише в приватному API: працює в процесі, але MCP‑клієнти ніколи не бачать get_document_info чи extract_text як інструменти першого класу.
  • Очікування пакету NuGet MCP: недоступний для цього сервера; опублікований шлях — образ контейнера.

GroupDocs.Parser заповнює прогалину, поєднуючи Docker‑сервер MCP з тими ж API Parser, які вже використовують ваші .NET‑служби.


Рішення: GroupDocs.Parser у робочому процесі платформи MCP

GroupDocs.Parser для .NET стає верифікаційною частиною історії MCP. Parser.GetDocumentInfo, Parser.GetText, GetFormattedText(Markdown) та GetTables відображають інструменти, які GroupDocs.Parser.Mcp надає MCP‑клієнтам. Прикладний репозиторій записує Result/mcp-server.example.json для реєстрації, а потім випробовує три найчастіше використовувані інструменти проти включених DOCX та XLSX файлів, щоб оператори могли переглянути результати у Result/.

Щоб слідувати наведеній реалізації, вам знадобиться:

  • .NET 8 SDK
  • GroupDocs.Parser 26.10.0
    (тимчасова ліцензія)
  • Прикладні документи (у репозиторії є sample.docx, sample.xlsx, sample.pdf)
  • Docker Engine лише під час запуску живого сервера MCP
dotnet add package GroupDocs.Parser --version 26.10.0

Реалізація інструментів MCP крок за кроком

Ось як зареєструвати GroupDocs.Parser.Mcp і перевірити API, еквівалентні інструментам. Сценарій відповідає платформеній команді, що вводить інструменти документів для асистентів на .NET 8.

Крок 1 – Створення реєстрації Docker MCP

Запишіть запис mcpServers, який запускає контейнер інтерактивно і монтує папку документів хоста у /data. Закріпіть теги у спільних конфігураціях.

// JSON для MCP‑клієнтів: 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
            }
        }
    },

Продовжуйте зі списком інструментів і запишіть JSON у UTF‑8 для імпорту клієнтом:

    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);

Крок 2 – Віддзеркалення get_document_info для попередніх перевірок

MCP‑клієнти часто викликають get_document_info перед важчими інструментами. Віддзеркалюйте цей контракт за допомогою Parser.GetDocumentInfo, щоб схеми залишалися стабільними.

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);

Чому ці поля важливі для операцій платформи:

  • fileType: Підтверджує, що парсер розпізнав формат перед запуском текстових інструментів
  • pageCount: Дешевий сигнал для розрахунку бюджету контексту MCP‑клієнта
  • sizeBytes: Підтримує квоти та перевірки аномалій при завантаженні файлів

Для включеного sample.docx записаний запуск повідомляє тип Microsoft Word Open XML, 2 сторінки та 15214 байт.

Крок 3 – Віддзеркалення extract_text для виводу, придатного асистенту

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;

Повернення кількості символів дає CI та консолям вимірюваний сигнал успішності, який відповідає тому, що оператори очікують від інструмента MCP extract_text.

Крок 4 – Віддзеркалення extract_tables у Markdown для чат‑інтерфейсів

Надавайте відформатований Markdown, а при його відсутності повертайте pipe‑таблиці з GetTables, щоб чат‑клієнти мали стабільний шлях рендерингу.

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);
    }
}

Коли відформатований Markdown недоступний, перевіряйте можливості та структурні таблиці:

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;
}

Подальші системи можуть архівувати Markdown поруч із вихідним XLSX або подавати pipe‑таблиці безпосередньо у чат‑панелі MCP‑клієнта без другого конвертера.


Чому командам платформи варто зберігати і Docker MCP, і бібліотечні дзеркала?

Зберігайте Docker MCP, коли MCP‑клієнти мають викликати іменовані інструменти над файлами у /data через ghcr.io/groupdocs-parser/parser-net-mcp. Зберігайте бібліотечні дзеркала, коли PR‑и мають довести get_document_info, extract_text і extract_tables без живого рукостискання. Такий подвійний шлях розділяє політику контейнерів і регресії парсингу. Закріпіть тег продакшн і запускайте .NET‑дзеркала у CI при кожному оновленні пакету Parser, як показано у прикладі репозиторію.


Реальний робочий процес: введення інструментів документів для спільного флоту MCP‑клієнтів

Платформна команда, що підтримує три продуктові підкоманди, підтримує одну базову конфігурацію MCP‑клієнта. Кожна підкоманда кидає політики DOCX та листи XLSX у спільний том документів. Перед тим, як просунути новий тег parser-net-mcp, команда запускає .NET‑консольний хост: JSON реєстрації регенерується, document-info.json порівнюється з золотими значеннями (2 сторінки / 15214 байт для тестового DOCX), логуються підрахунки символів тексту, а Markdown з листів Sheet1/Sheet2 XLSX‑зразка переглядається на предмет структури pipe‑таблиці.

Цей процес відповідає крокам вище. Крок 1 — конфігурація флоту. Кроки 2‑4 — офлайн‑ворота. Лише після успішного проходження цих воріт закріплений образ контейнера розгортається на хостах MCP‑клієнтів. При Docker‑специфічних помилках оператори користуються
MCP troubleshooting guide.


Бізнес‑вплив: що це змінює

Показник До (ад‑hoc) Після (GroupDocs.Parser + MCP)
Реєстрація клієнта Ручні нотатки, розбіжність між ноутбуками JSON mcpServers у репозиторії
Перевірка контракту інструменту Тільки після провалу живих викликів MCP Офлайн‑фікстури JSON/текст/Markdown
Доставка таблиць у чат Кастомні CSV‑конвертери Markdown, узгоджений з extract_tables
Розповсюдження пакету Очікування NuGet MCP Чітко Docker‑only сервер + NuGet бібліотека
Дрейф образу Плаваючий :latest Закріплені теги, наприклад :26.9.0
Аудит‑трасування Лише журнали чату Артефакти у Result/ за кожен запуск

Сумарний ефект — швидше введення MCP‑клієнтів і менше сюрпризів у продакшн, коли політика контейнерів і поведінка парсингу рухаються різними годинниками.


Інші сценарії платформи, де це підходить

Після налаштування реєстрації та дзеркал ті ж API підтримують:

  • Попередні ворота інжесту: відхиляти завантаження, коли pageCount або sizeBytes виходять за межі політики, ще до запуску MCP‑клієнтів
  • Огляд електронних таблиць: надсилати Markdown‑таблиці з XLSX у боті стендапу
  • Пакети «дим‑тесту» у кількох форматах: тримати DOCX, XLSX і PDF зразки поруч із конфігурацією MCP для щотижневих регресій
  • Сайдкар‑розгортання: запускати GroupDocs.Parser.Mcp поряд із .NET API, що ще використовує в‑процесі Parser для внутрішніх завдань

Перші кроки у вашому середовищі платформи

Ви вже бачили, як GroupDocs.Parser обробляє інструменти документів MCP для команд платформи на .NET. Наступні кроки:

Ресурси