플랫폼 팀이 GroupDocs.Parser를 사용해 .NET에서 MCP 클라이언트에 문서 도구를 연결하는 방법
💡 전체 작동 예제는 GitHub에서 확인할 수 있습니다: parser-mcp-document-tools-dotnet
플랫폼 과제: 왜 문서 도구가 MCP 경계에서 멈추는가
Docker 기반 문서 도구를 MCP 클라이언트에 배포하는 패턴은 .NET에서 GroupDocs.Parser.Mcp 배포 패턴으로, 컨테이너 이미지와 get_document_info, extract_text, extract_tables에 대한 오프라인 라이브러리 검사를 짝지어 사용합니다. 어시스턴트를 위한 문서 도구를 제공하는 플랫폼 엔지니어링 팀은 “DOCX를 파싱할 수 있나요?”와 같은 문제에 거의 부딪히지 않습니다. 대신 더 날카로운 제약에 직면합니다: MCP 서버는 클라이언트 설정에 명명된 도구 목록으로 나타나야 하는데, 파싱 엔진이 너무 커서 GroupDocs.Parser.Mcp는 NuGet 패키지가 아니라 컨테이너 이미지로만 제공됩니다.
제품 스쿼드가 문서 정보, 순수 텍스트, 채팅용 테이블을 MCP 클라이언트 안에 요청하면, 플랫폼 팀은 두 가지 트랙을 이어받게 됩니다. 첫 번째 트랙은 운영: /data에 볼륨을 마운트한 docker run, :26.9.0 같은 고정 태그, 그리고 안정적인 mcpServers 항목. 두 번째 트랙은 검증: 라이브 핸드셰이크에 의존하기 전에 GroupDocs.Parser for .NET이 동일한 결과를 반환한다는 것을 증명합니다. 어느 트랙이라도 놓치면 실패는 빈 MCP 클라이언트 응답으로 나타나며, 단위 테스트 실패와는 다릅니다.
팀이 실제로 필요로 하는 것은 명확합니다: MCP 클라이언트에 붙여넣을 수 있는 등록 스니펫과, 검토용 JSON, 텍스트, Markdown 아티팩트를 생성하는 오프라인 C# 호출. 저는 파트너가 Docker가 개발자 노트북에서 승인되기 전 채팅에서 extract_tables를 요구했을 때 이 문제에 직면했으며, 라이브러리 미러가 보안 검토가 끝날 때까지 전달을 계속 진행하게 했습니다.
산업 현황:
GroupDocs.Parser.Mcp는
ghcr.io/groupdocs-parser/parser-net-mcp에 게시되며 엔진이 NuGet 크기 제한을 초과하기 때문에 Docker‑only 배포를 문서화합니다. 따라서 로컬 데모는 라이브 MCP 세션 없이도 도구와 동등한 API를 검증합니다(MCP docs).
왜 일반적인 접근 방식이 여기서는 부족한가
팀은 전용 MCP 문서 서버를 도입하기 전에 보통 다음 경로 중 하나를 시도합니다:
- 데스크톱 변환기를 둘러싼 임시 쉘 스크립트: DOCX와 XLSX에서 깨지기 쉽고, 명명된 MCP 도구를 제공하지 못합니다.
- 파서를 전용 API에서만 호출: 프로세스 내부에서는 동작하지만 MCP 클라이언트는
get_document_info나extract_text를 일급 도구로 보지 못합니다. - NuGet MCP 패키지를 기다림: 이 서버에는 제공되지 않으며, 공개 경로는 컨테이너 이미지입니다.
GroupDocs.Parser는 Docker MCP 서버와 .NET 서비스가 이미 사용하고 있는 동일한 Parser API를 짝지어 격차를 메웁니다.
솔루션: 플랫폼 MCP 워크플로우에서 GroupDocs.Parser
.NET용 GroupDocs.Parser는 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에서 어시스턴트를 위한 문서 도구를 온보딩하는 플랫폼 스쿼드와 일치합니다.
Step 1 - Docker MCP 등록 정보 생성
컨테이너를 인터랙티브하게 실행하고 호스트 문서 폴더를 /data에 마운트하는 mcpServers 항목을 작성합니다. 공유 설정에서는 태그를 고정합니다.
// 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
}
}
},
도구 목록을 이어서 작성하고 클라이언트 가져오기를 위한 UTF-8 JSON을 저장합니다:
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);
Step 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 바이트입니다.
Step 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 도구가 기대하는 성공 신호를 측정할 수 있습니다.
Step 4 - 채팅 UI용 Markdown 형태 extract_tables 미러링
우선 포맷된 Markdown을 시도하고, 불가능할 경우 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 옆에 보관하거나, 파이프 테이블을 그대로 MCP 클라이언트 채팅 창에 전달해 두 번째 변환기를 거치지 않게 할 수 있습니다.
왜 플랫폼 팀이 Docker MCP와 라이브러리 미러를 모두 유지해야 하는가?
MCP 클라이언트가 /data 아래 파일에 대해 명명된 도구를 호출해야 할 경우 Docker MCP를 유지합니다(ghcr.io/groupdocs-parser/parser-net-mcp). PR에서 get_document_info, extract_text, extract_tables를 라이브 핸드셰이크 없이 검증해야 할 경우 라이브러리 미러를 유지합니다. 이 이중 경로는 컨테이너 정책과 파싱 회귀를 분리합니다. 프로덕션 태그를 고정하고, 샘플 레포지토리가 보여 주듯 매 Parser 패키지 업데이트마다 .NET 미러를 CI에서 실행합니다.
실제 워크플로: 공유 MCP 클라이언트 풀에 문서 도구 온보딩
세 개의 제품 스쿼드를 지원하는 플랫폼 팀은 하나의 MCP 클라이언트 베이스라인을 관리합니다. 각 스쿼드는 DOCX 정책과 XLSX 요율표를 공유 문서 볼륨에 넣습니다. 새 parser-net-mcp 태그를 승격하기 전에 팀은 .NET 콘솔 호스트를 실행합니다: 등록 JSON이 재생성되고, document-info.json이 골드값(스모크 DOCX 기준 2 페이지 / 15214 바이트)과 비교되며, 텍스트 문자 수가 로그에 기록되고, XLSX 샘플의 Sheet1/Sheet2 Markdown이 파이프 테이블 구조로 검토됩니다.
이 워크플로는 위 단계와 직접 매핑됩니다. Step 1은 풀 설정, Step 2‑4는 오프라인 게이트입니다. 이 게이트를 통과해야 고정된 컨테이너 이미지가 MCP 클라이언트 호스트에 배포됩니다. Docker‑specific 오류가 발생하면 운영자는
MCP 트러블슈팅 가이드를 참고합니다.
비즈니스 영향: 변화된 점
| 지표 | 이전 (임시) | 이후 (GroupDocs.Parser + MCP) |
|---|---|---|
| 클라이언트 등록 | 수동 메모, 노트북마다 드리프트 | 체크인된 mcpServers JSON |
| 도구 계약 검증 | 라이브 MCP 호출 실패 후에만 | 오프라인 JSON/텍스트/Markdown 고정물 |
| 채팅용 테이블 전달 | 맞춤 CSV 변환기 | extract_tables와 정렬된 Markdown |
| 패키지 배포 | NuGet MCP 기대 | Docker‑only 서버 + NuGet 라이브러리 명확 |
| 이미지 드리프트 | 플로팅 :latest |
:26.9.0 같은 고정 태그 |
| 감사 추적 | 채팅 로그만 | 실행당 Result/ 아티팩트 |
복합 효과는 MCP 클라이언트 온보딩 속도를 높이고, 컨테이너 정책과 파싱 동작이 서로 다른 시계에서 움직일 때 발생하는 프로덕션 서프라이즈를 감소시킵니다.
이와 맞는 다른 플랫폼 시나리오
등록과 미러가 준비되면 동일한 API가 다음을 지원합니다:
- 사전 인제스트 게이트: MCP 클라이언트가 실행되기 전에
pageCount또는sizeBytes가 정책을 벗어나면 업로드를 거부 - 스프레드시트 브리핑: XLSX에서 Markdown 테이블을 스탠드업 봇에 전송
- 다중 포맷 스모크 팩: DOCX, XLSX, PDF 샘플을 MCP 설정 옆에 보관해 주간 회귀 테스트 수행
- 사이드카 롤아웃: 내부 작업에 아직 인‑프로세스 Parser를 사용하는 .NET API 옆에
GroupDocs.Parser.Mcp실행
플랫폼 환경에서 시작하기
GroupDocs.Parser가 .NET 플랫폼 팀을 위해 MCP 문서 도구를 어떻게 처리하는지 보았습니다. 다음 단계:
- 무료 시작: 임시 라이선스 받기
- MCP 설정 읽기: GroupDocs.Parser MCP 문서
- 사용 사례 따라하기: MCP를 통한 문서 파싱
- 예제 살펴보기: GroupDocs.Parser for .NET 샘플
- 질문하기: Parser 포럼