Skip to content
MCP server

Korean Government Documents (HWPX)

Turns drafts into Korean government reports, press releases and memos as HWPX files

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.5.6
Listing updated
today

Similar MCP servers

About Korean Government Documents (HWPX)

Korean Government Documents (HWPX) is an open-source MCP server for legal and government. It runs locally on your machine and is started by your AI client.

Korean-language official documents follow ministry-specific layouts, and this server encodes them. Your AI organises notes into a document structure, the server supplies writing rules, checks the structure, and then renders an HWPX file using format values for the relevant central government body. The README says the formats come from a study of 2,670 press releases and covers 52 central agencies for press releases and 42 for reports.

Three document types are supported: reports in the bullet-hierarchy style, press releases, and draft approval documents (기안문) with numbering, approval box and the closing mark. A target page count triggers warnings when a draft overflows or runs short, and a simplified mode adds a numbered layout and a Markdown copy.

Everything runs on your computer with no API key and no data sent out, and files are saved under ~/korean-report-hwpx/. Output is a draft to verify in Hancom Office.

Install

Run in a terminal

claude mcp add korean-report-hwpx -- uvx korean-report-hwpx

Add to claude_desktop_config.json

{
  "mcpServers": {
    "korean-report-hwpx": {
      "command": "uvx",
      "args": [
        "korean-report-hwpx"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "korean-report-hwpx": {
      "command": "uvx",
      "args": [
        "korean-report-hwpx"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "korean-report-hwpx": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "korean-report-hwpx"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "korean-report-hwpx": {
      "command": "uvx",
      "args": [
        "korean-report-hwpx"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "korean-report-hwpx": {
      "command": "uvx",
      "args": [
        "korean-report-hwpx"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

get_writing_guide
Returns writing rules, document-type criteria and the structure schema.
draft_press_structure
Turns a fact memo into a draft press-release structure.
check_structure
Checks a structure before generation.
build_document
Builds an HWPX file in an agency's format.
build_from_structure
Alias of build_document.
list_ministries
Lists supported agencies and document types.
get_rules
Returns formatting rules for an agency and document type.

What it does

Ministry formats
Press releases for 52 agencies and reports for 42, with a common fallback.
Three document types
Reports, press releases and approval documents.
Structure checks
Flags symbols in text, skipped hierarchy, overlong titles and page-count problems.
Page targeting
Warns when a draft overflows or underfills a target length.
Local processing
No external transmission and no API key.
Simplified style
Numbered layout with a Markdown copy.

Good for

  • Turn meeting notes into a one-page internal report
  • Prepare a ministry-style press release from a fact memo
  • Draft an approval memo that attaches a report
  • Look up a ministry's formatting rules

Pricing

Open source

Korean Government Documents (HWPX) FAQ

Does it send my text anywhere?

No. The README says processing stays on your computer with no external transmission.

Do I need an API key?

No.

Where are files saved?

In ~/korean-report-hwpx/, changeable with KOREAN_REPORT_HWPX_OUT_DIR.

Is the output final?

The README calls it a draft to check in Hancom Hangul before use.

Is Korean Government Documents (HWPX) free?

Yes. Korean Government Documents (HWPX) is open source, so you can use and self-host it for free.

How do I add Korean Government Documents (HWPX) to Claude Code?

Run this command in your terminal: claude mcp add korean-report-hwpx -- uvx korean-report-hwpx

What are the best alternatives to Korean Government Documents (HWPX)?

The closest alternatives to Korean Government Documents (HWPX) are SSRS2, Csv, Datos Cl, Data Ny and Cipo.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers