← Back to directory

Kordoc

Community

Convert Korean documents (HWP, HWPX, PDF, Office) to Markdown with CLI and MCP server, featuring form filling and diff.

GitHub source repository ↗

★ 1.8k Stars Category · Other Very popular Source revision 84ef58aaa50c

59FMRS · C

Reliability

9/20

Security and permissions

11/20

Maintenance

13/20

Documentation

14/20

Setup experience

12/20

Kordoc is a powerful document processing tool especially adept at handling Korean government documents. It offers broad format support, a rich set of MCP tools, and high customizability. For AI workflows requiring automated processing of Korean documents, it is a reliable choice, but its name and documentation language may not suit non-Korean users.

Read the FMRS scoring method →

Kordoc is a CLI and MCP server specialized in handling Korean official documents. It can parse HWP 3.x/5.x, HWPX, HWPML, PDF, XLS, XLSX, DOCX, and images (PNG/JPG/WebP) into Markdown. It offers form filling, document diff, format-preserving patches, Markdown to HWPX generation, PII redaction, and more. Developed by a former public official from Korea, it has been extensively tested against real government documents.

Tools

parse_document

Parse HWP/HWPX/PDF/XLSX/DOCX documents to Markdown with metadata.

detect_format

Detect file format using magic bytes.

parse_metadata

Extract only the metadata of a document.

parse_pages

Parse a specific page range of a document.

parse_table

Extract the Nth table from a document.

compare_documents

Compare two documents, supporting cross-format comparison and generating diff reports.

parse_form

Extract form fields from a document as JSON.

fill_form

Fill values into a form template while preserving original HWPX formatting and integrity guards.

patch_document

Apply edited Markdown patches to the original HWPX or HWP file, preserving formatting.

extract_profile

Extract a table format profile from a reference HWPX, reusable for document generation.

generate_document

Generate an HWPX file from Markdown, including tables, formulas, and charts, with official document presets.

place_seal

Place a seal or signature image over anchor text for automatic stamping.

render_document

Render HWPX to PNG or SVG preserving original layout, supporting multi-page and search highlights.

redact_document

Detect and mask PII such as resident numbers, phones, emails, cards, and bank accounts while preserving formatting.

parse_chunks

Generate structured text chunks for RAG, preserving headings and hierarchy.

Setup

Ensure Node.js 18+ is installed.
Run npx -y kordoc setup and select your AI client (automatic configuration).
Or manually edit your MCP client configuration file to add:

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

For Windows, you may need cmd /c npx wrapper.

claude_desktop_config.json

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

Generate and validate client config

Fit and risk

Best for

Developers or teams needing to process Korean official documents like HWP and HWPX.
Users who need to parse and generate official documents in AI-assisted workflows.
Automation tasks involving a large number of Korean government or public sector documents.

Not for

Users needing non-Korean document formats (e.g., pure English Office docs) – although supported, it's not the primary focus.
General MCP use cases not requiring document conversion or heavy document handling.

Required permissions

Read and write local files (document parsing, generation, patching).
Network access: downloads OCR model (~18MB) on first use.
May read images (PNG/JPG/WebP) for OCR.

Risks and side effects

Processing untrusted files may present security risks, but the project includes security hardening like ZIP bomb and XXE protections.
OCR model download requires network access and may fail in offline environments.
Incorrect document parsing could lead to data loss; it's recommended to validate important documents.

Troubleshooting

If `npx -y kordoc setup` fails on Windows, use Command Prompt (cmd) instead of PowerShell, or set execution policy to RemoteSigned.
If you encounter `MODULE_NOT_FOUND`, first run `npm uninstall -g kordoc`, then re-run the setup.
If PDF parsing yields garbled text, try enabling OCR: add `ocr: true` parameter in MCP calls.
For corrupted HWP files, Kordoc may not be able to fix them; ensure original files are not damaged.

Use cases

Convert Korean government office documents like .hwp and .hwpx to Markdown for AI processing.

Automatically fill official forms and documents such as reports and plans.

Compare document versions to generate diff reports with added/removed/modified content.

Convert AI-generated Markdown back into standard-format HWPX official documents.

Redact documents containing personal information.

Supported clients

Claude DesktopFull support

CursorFull support

WindsurfFull support

Claude CodeFull support

VS CodeFull support

Gemini CLIFull support

ZedFull support

CodexFull support

Related MCP servers

Compare with other MCP servers