# Korean Government Documents (HWPX)

Turns a memo or draft into a Korean official report or press release as HWPX, styled to a chosen ministry. Everything runs on your machine.

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

## What it does

This server hands the assistant a small set of tools for Korean public documents. `get_writing_guide` explains how to tell a report from a press release and from an internal approval form, and returns the layout rules plus a JSON schema. `build_document` turns that structure into a finished HWPX file in the selected ministry's format and reports back a `warnings` list. A check step, `check_structure`, runs before generation and flags missing fields, stray symbols inside text, skipped hierarchy levels and overlong titles.

Two layout modes ship with it. The default follows ministry conventions: the □, ㅇ and - markers, notes, a reference block, tables, appendices. `style="simplified"` numbers the levels itself (Ⅰ → 1 → 가 → 1) → 가)), allows ordinary verb endings and drops the title frame and table header shading. For an internal approval report use `report_kind="internal"`; for the official letter form set `doc_type="official"` and fill in the signature grid.

The only prerequisite is `uv`, since the server starts through `uvx`. No API key, no environment variables. Output files land in `~/korean-report-hwpx/`, and `KOREAN_REPORT_HWPX_OUT_DIR` points them elsewhere. Keep in mind what the server does not do: it supplies structure and layout, while facts and figures come from the model writing the text, so invented numbers are the model's fault, not the server's.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add korean-report-hwpx -- uvx korean-report-hwpx
```
uvx runs the command named after the package; if the README names another one, use uvx --from korean-report-hwpx <command>

### Codex

**Platform CLI**
```bash
codex mcp add korean-government-documents-hwpx -- uvx korean-report-hwpx
```
uvx runs the command named after the package; if the README names another one, use uvx --from korean-report-hwpx <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "korean-government-documents-hwpx": {
            "command": "uvx",
            "args": [
                "korean-report-hwpx"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from korean-report-hwpx <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "korean-government-documents-hwpx": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "korean-report-hwpx"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from korean-report-hwpx <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add korean-government-documents-hwpx uvx korean-report-hwpx
```
uvx runs the command named after the package; if the README names another one, use uvx --from korean-report-hwpx <command>

## When to use it
- draft an internal approval report from rough notes
- issue a press release in one ministry's house style
- validate document structure before building the file
- save the same text as Markdown next to the HWPX
- look up layout rules for a given ministry

## Example prompts
- Turn this memo into a report for the Ministry of the Interior and Safety as HWPX
- Format the draft as a National Tax Service press release, morning release tomorrow
- Rebuild the last report in simplified mode and keep `report.md` next to it

## Similar
- [Excel MCP Server](https://affpapa.org/en/nevibecode/mcp/excel-mcp-server.md) — MCP server · ★ 4259
- [kordoc](https://affpapa.org/en/nevibecode/mcp/kordoc.md) — MCP server · ★ 2726
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/en/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP server · ★ 1247
- [Microsoft 365 MCP Server](https://affpapa.org/en/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP server · ★ 1074
- [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

---
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