AI Briefing
추천

kordoc, 한국 문서→Markdown 변환 MCP 서버 공개

kordoc: HWP와 PDF 등 한국 문서를 마크다운으로 바꾸는 파서 겸 MCP 서버

·2026.07.23 20:30

핵심 내용

HWP·PDF·Office 문서를 마크다운으로 변환하고 MCP 서버로 AI 에이전트와 연동하는 오픈소스 도구 kordoc이 공개됐다.

자세히 보기

kordoc은 HWP 3.x/5.x, HWPX, HWPML, PDF, XLS/XLSX, DOCX, 이미지(PNG/JPG/WebP)를 마크다운으로 변환하는 CLI 도구이자 MCP(Model Context Protocol) 서버다. TypeScript로 작성되어 npm 패키지로 배포되며, Node.js 18 이상에서 동작한다.

주요 기능:

  • RAG 파이프라인 지원: --format chunks 옵션으로 헤딩 위계를 breadcrumb으로 보존한 구조 청크(JSON) 출력
  • 로컬 OCR: 한국어 PP-OCRv5 모델(~18MB)을 내장해 API 키 없이 스캔 문서 처리
  • 서식 보존 라운드트립: 편집된 마크다운을 원본 HWPX/HWP에 반영할 때 텍스트만 교체하고 나머지 서식 유지. 자체 벤치마크에서 HWPX 텍스트 재현율 99.998%, 표 구조 정확도 100%(1,421개 표)
  • 마크다운 → HWPX 생성: 행정 공문서 표준 서식(기안문·보고서·공고문 프리셋) 지원

MCP 서버로 등록하면 Claude Desktop, Cursor, Claude Code 등 AI 클라이언트가 parse_document, fill_form, redact_document 등 총 15개 도구를 직접 호출할 수 있다. npx -y kordoc setup 명령 하나로 설치된 AI 클라이언트를 자동 감지해 설정 파일을 패치한다.

MIT 라이선스로 공개되어 상업적 이용이 가능하다.

이 한국어 요약은 AI가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.

AI 처리 방식을 확인하거나, 요약 오류와 출처 표기 문제, 삭제 요청을 문의 · 건의로 알려주세요.