# Korean Government Documents (HWPX)

> Korean Government Documents (HWPX) is an open-source MCP server for legal and government. Turns drafts into Korean government reports, press releases and memos as HWPX files. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Repository:** https://github.com/upstageai/korean-report-hwpx
- **MCP Registry name:** io.github.UpstageAI/korean-report-hwpx
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government), [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

## Alternatives

- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [Csv](https://ai-powered.com/mcp/csv): Csv is a freemium MCP server for files and documents.
- [Datos Cl](https://ai-powered.com/mcp/datos-cl): Datos Cl is a freemium MCP server for legal and government.
- [Data Ny](https://ai-powered.com/mcp/data-ny): Data Ny is a freemium MCP server for legal and government.
- [Cipo](https://ai-powered.com/mcp/cipo): Cipo is a freemium MCP server for legal and government.
- [Data Europa](https://ai-powered.com/mcp/data-europa): Data Europa is a freemium MCP server for legal and government.
- [Data Govt Nz](https://ai-powered.com/mcp/data-govt-nz): Data Govt Nz is a freemium MCP server for legal and government.
- [Data Cityofchicago](https://ai-powered.com/mcp/data-cityofchicago): Data Cityofchicago is a freemium MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/korean-government-documents-hwpx
