Korean Government Documents (HWPX) MCP server

korean-report-hwpx — 한국 공문서 MCP (보고서·보도자료 HWPX)

<!-- mcp-name: io.github.UpstageAI/korean-report-hwpx -->

· English

0.2.0부터 업스테이지 Solar Pro 4로 개발합니다. 간소화 모드·마크다운 출력·내부 결재 보고서는 Solar Pro 4가 코드를 작성하고, Claude가 결과를 검증했습니다.

공무원 공문서(보고서·보도자료)를 기관 서식 HWPX로. 쓰고 있는 AI(Claude·ChatGPT 등)가 메모·초안을 공문서 구조로 정리하면, 52개 중앙행정기관의 서식 규칙값으로 한글(HWPX) 파일을 그립니다.

외부 전송 없음 · API 키 불필요 — 모든 처리는 설치한 컴퓨터 안에서 끝납니다. 원고는 이 서버 밖으로 나가지 않습니다. → English README

"이 내용 공문서처럼 써 줘" 한마디로 개조식 보고서(□ → ㅇ → -) 또는 보도자료를 기관 서식대로 만듭니다. 서식은 정책브리핑 보도자료 2,670건 전수 조사로 정한 규칙값이며, 원본 문서·로고는 포함하지 않습니다.

이렇게 물어보세요

• "이 메모를 ○○부 보고서로 만들어 줘"
• "회의 내용 정리한 거야. 공문서처럼 정리해 줘" (기관을 말하지 않으면 공통 서식)
• "이 원고 국세청 보도자료로 만들어 줘 — 보도시점 2026. 10. 8.(목) 조간"
• "아까 만든 보고서 구조에서 Ⅲ장 □ 문장만 바꿔서 다시 만들어 줘"
• "산림청 보고서 서식 규칙(계층별 기호·글꼴·크기) 보여 줘"

설치 한 줄 — claude mcp add korean-report-hwpx -- uvx korean-report-hwpx

문서 종류

사용 흐름 — AI에게 "이 메모를 ○○부 보고서로 만들어 줘" → AI가 getwritingguide로 작성 규칙 확인 → 원고를 구조 JSON으로 작성 → build_document → 결과의 warnings(고칠 점)가 있으면 AI가 고쳐 다시 생성.

문서 종류 판단 기준(가이드에 포함): 언론·국민 대상 발표·배포용이면 보도자료, 내부 보고·계획·검토면 보고서, 행정업무규정 별지 제1호서식 기안문·시행문이 필요하면 official.

설치

uv가 있으면 설치 없이 바로 실행됩니다.

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

Claude Code: claude mcp add korean-report-hwpx -- uvx korean-report-hwpx

• API 키·환경변수 필요 없음.
• 만든 파일은 ~/korean-report-hwpx/에 저장됩니다(KOREANREPORTHWPXOUTDIR로 변경, 이전 이름 KOREANGOVDOCSOUTDIR도 인식).

도구

간소화 모드 (style="simplified")

AI가 읽기 쉬운 보고서 서식(번호 체계 표준화, 서술식 문장, 단순한 표). 항목 기호를 단계별 번호로 자동 부여하고, 제목 상자·표 머리 음영을 없앤 간결한 서식.

사용법: builddocument(..., style="simplified") 또는 getwriting_guide(..., style="simplified")로 지정.

Shortened. The full README is on GitHub.