# kordoc

Parses HWP, HWPX, PDF, spreadsheet files, and scans into Markdown locally. Gives coding assistants tools to inspect tables, diff revisions, and fill forms.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2726
- Author: chrisryugj
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/chrisryugj/kordoc
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/kordoc

## What it does

kordoc connects 18 tools to the coding agent for handling Korean documents. It reads HWP 3.x, HWP 5.x, HWPX, HWPML, alongside PDF, DOCX, and XLSX files. The server parses merged table cells and extracts text from image scans using local OCR. Markdown notes can also be rendered back into HWPX files using preset templates.

Running this server requires Node.js 20 or newer. It works in isolated networks without remote servers. Setting `KORDOC_OFFLINE=1` cuts all external traffic, running text recognition directly on the CPU without API keys. Installing dependencies with `--omit=optional` strips PDF and OCR features.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add kordoc -- npx -y kordoc
```

### Codex

**Platform CLI**
```bash
codex mcp add kordoc -- npx -y kordoc
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kordoc": {
            "command": "npx",
            "args": [
                "-y",
                "kordoc"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kordoc": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "kordoc"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add kordoc npx -y kordoc
```

## When to use it
- convert HWP and HWPX files into Markdown while preserving table structures
- extract text from scans and PDF pages without third-party API keys
- diff document revisions across structured blocks and table cells
- build styled HWPX files from Markdown notes using template presets
- audit arithmetic totals in budget tables

## Example prompts
- Read `report.hwpx` and format the second table as Markdown.
- Compare `draft_v1.hwp` against `draft_v2.hwpx` to highlight cell edits.
- Generate `output.hwpx` from `notes.md` using the standard report template.

## Similar
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/en/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP server · ★ 1247
- [anymd](https://affpapa.org/en/nevibecode/mcp/anymd.md) — MCP server · ★ 1051
- [Docling MCP](https://affpapa.org/en/nevibecode/mcp/docling-mcp.md) — MCP server · ★ 777
- [OpenTakeoff](https://affpapa.org/en/nevibecode/mcp/opentakeoff.md) — MCP server · ★ 667
- [canvas-mcp](https://affpapa.org/en/nevibecode/mcp/canvas-mcp.md) — MCP server · ★ 307
- [reMarkable MCP Server](https://affpapa.org/en/nevibecode/mcp/remarkable-mcp-server.md) — MCP server · ★ 252

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md