BACK TO MCP SERVERS
productivityany

kordoc

Parse Korean documents (HWP, HWPX, PDF, XLSX, DOCX, PPTX) to Markdown; fill forms, diff, render.

At a glance

Not tested yet
GitHub stars
3,050
Weekly downloads
74,010
Last commit
2026-11-19
Licence
MIT
Transport
stdio
Auth
none
Install
npx -y kordoc
Stats checked 2026-11-19

What it does

kordoc is an MCP server that lets an AI agent read and write Korean public documents. It turns HWP 3.x and 5.x, HWPX, HWPML, PDF, XLS, XLSX, DOCX, PPTX and image files into Markdown and structured data, and builds HWPX and HWP documents from Markdown. It is aimed at people working with Korean government and office paperwork. It is also available as a library and a CLI.

같은 법령 별표를 HWP·HWPX·PDF·스캔 이미지로 넣은 kordoc 실제 출력
Image: chrisryugj/kordoc (MIT)

Tools it gives your agent

The README says the client exposes 22 tools for parsing, comparing, generating, checking and rendering, but it does not name them individually. The documented capabilities behind them are:

  • Reading documents into Markdown, IR, per-page body text and RAG chunks, with local OCR and QR values from images.
  • Comparing and editing at block and cell level, and patching HWPX and HWP while keeping formatting.
  • Writing Markdown into HWPX and HWP with public-document presets, department templates and report layout.
  • Converting HWP 5.x to HWPX with formatting kept, and other formats into HWPX.
  • Filling form fields and standard draft templates, and applying seals.
  • Checking spelling, public language, structure, AI writing style and budget calculations.
  • Previewing HWPX and HWP, extracting regions and masking personal information.

Quick start

Node.js 20 or later is required, on macOS, Linux or Windows.

npm install kordoc
npx -y kordoc setup

Restart the client afterwards to use the tools.

Add it to Claude Code from a terminal:

claude mcp add kordoc -- npx -y kordoc

Or add this to .mcp.json in your project root (Claude Code) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "kordoc": {
      "command": "npx",
      "args": [
        "-y",
        "kordoc"
      ]
    }
  }
}

Environment variables

  • KORDOC_OFFLINE: set to 1 to block all external communication, with OCR running locally on CPU without an API key.
  • KORDOC_ROOT: the MCP access scope.
  • KORDOC_SANDBOX: set to gvisor to run the parser inside a gVisor sandbox on Linux.

Example prompts

  • Convert this HWPX file to Markdown and show me the tables.
  • Read this scanned PDF with OCR and save the text as Markdown.
  • Compare these two versions of the report and list the changed cells.
  • Fill the standard draft template with the values in this JSON file.

What to watch out for

  • Node.js 20 or later is required.
  • OCR, image format conversion and QR reading depend on optional dependencies. Installing with --omit=optional limits those features.
  • Writing HWP output needs @rhwp/core installed first.
  • --jobs converts files in parallel and increases memory use.
  • The README gives no pricing or cost information.

Not tested by tools4agents yet. Read the source repository before you install it.

GitHub SourceGitHub Stars
Last verified 2026-11-19

Similar tools