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 라이선스로 공개되어 상업적 이용이 가능하다.

이 요약은 원문 이해를 돕기 위한 큐레이션입니다. 저작권은 원저작자에게 있으며, 정확한 내용과 맥락은 원문을 확인하세요.

요약 오류, 출처 표기 문제, 삭제 요청은 문의 · 건의로 알려주세요.