Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Korean Government Documents (HWPX)

by UpstageAIversion 0.5.6i★ 24iRuns on your computerRepository ↗
Registry nameio.github.UpstageAI/korean-report-hwpx

How to install

What it does

Korean government reports, press releases and official drafts as HWPX in each agency's format

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Law & government data

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity17/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score29/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Korean Government Documents (HWPX). Follow https://mcp.popnx.com/i/upstageai-korean-report-hwpx.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Korean Government Documents (HWPX) for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "korean-report-hwpx": { "command": "uvx", "args": [ "korean-report-hwpx" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Korean Government Documents (HWPX) tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "korean-report-hwpx": {
          "command": "uvx",
          "args": [
            "korean-report-hwpx"
          ]
        }
      }
    }
  4. Quit Claude and open it again

  5. Try it

    Use Korean Government Documents (HWPX) and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Korean Government Documents (HWPX) or shows a Korean Government Documents (HWPX) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Korean Government Documents (HWPX) yet

Korean Government Documents (HWPX) runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Korean Government Documents (HWPX)

  • Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • Install Python (uv) on your computer first (one time)
  • Install Python (uv) on your computer first (one time)
  • Install Python (uv) on your computer first (one time)

B · Others in Law & government data that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Korean Government Documents (HWPX) for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user korean-report-hwpx -- uvx korean-report-hwpx 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Korean Government Documents (HWPX) tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user korean-report-hwpx -- uvx korean-report-hwpx
  4. Type /mcp in Claude Code

    You should see Korean Government Documents (HWPX) listed as connected

  5. Try it

    Use Korean Government Documents (HWPX) and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Korean Government Documents (HWPX) or shows a Korean Government Documents (HWPX) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Korean Government Documents (HWPX) for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "korean-report-hwpx": { "command": "uvx", "args": [ "korean-report-hwpx" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Korean Government Documents (HWPX) tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Open the AI chat in Cursor in Agent mode

  4. Try it

    Use Korean Government Documents (HWPX) and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Korean Government Documents (HWPX) or shows a Korean Government Documents (HWPX) tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Korean Government Documents (HWPX) for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "korean-report-hwpx": { "type": "stdio", "command": "uvx", "args": [ "korean-report-hwpx" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Korean Government Documents (HWPX) tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Open the AI chat in VS Code in Agent mode

  4. Try it

    Use Korean Government Documents (HWPX) and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Korean Government Documents (HWPX) or shows a Korean Government Documents (HWPX) tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Korean Government Documents (HWPX)💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

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

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
103/wk
Connection
Runs on your computer
Latest versioni
0.5.6
Published to registryi
Nov 14, 2026
Code last changedi
Nov 17, 2026
Maker
UpstageAI
Packages
pypi: korean-report-hwpx
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account UpstageAI, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 2 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for korean-report-hwpx@0.5.6

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/upstageai-korean-report-hwpx.svg)](https://mcp.popnx.com/en/servers/upstageai-korean-report-hwpx)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Law & government datai

  • More stars than 99% of the other 1939 servers in this category
  • Published to the registry more recently than 90% of the other 1939 servers in this category
  • Basic checks equal to or better than 99% of the other 1939 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Korean Government Documents (HWPX) safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 2 days ago, and the latest version (0.5.6) reached the registry 5 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

by lexifinaWidely used★ 2.1KUpdated 9 days ago

Runs in the cloud✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

by librejusticeEarly★ 36Updated 2 months ago

Runs in the cloud✓ service owner · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

by street1983nkEarly★ 18Updated 5 months ago

Runs in the cloud✓ service owner · infranode.dev

Fedlex Connector

Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.

by JayTheSkierEarly★ 8Updated 7 months ago

Runs in the cloud✓ service owner · fedlex-connector.ch
Compared with similar ones
This one
Korean Government Documents (HWPX)
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/44/44/44/44/4
LicenseMITNOASSERTIONMITApache-2.0Apache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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

영상: Claude 앱(코워크)에 "회의메모 보고 다른 기관 AI 교육 사례 찾아서 과장님 보고용 1쪽 보고서 만들어 줘. 교육 실시 계획 기안문도 같이 한글 파일로 줘" 요청 하나 → 사례 표·우리 기관 계획 1쪽 보고서 + 그 보고서를 붙임으로 단 내부결재 기안문(예산 '금1,200,000원(금일백이십만원)' 한글 병기)까지(2026-11-08 공개, 회의 메모는 가상 예시).

· English

공무원 공문서(보고서·보도자료·기안문)를 기관 서식 HWPX로. 쓰고 있는 AI(Claude·ChatGPT 등)가 메모·초안을 공문서 구조로 정리하면, 이 서버가 작성 규칙을 알려 주고 구조를 점검한 뒤 52개 중앙행정기관의 서식 규칙값으로 한글(HWPX) 파일을 그립니다. 서식은 정책브리핑 보도자료 2,670건 조사로 정한 값입니다. 도구 7개, 외부 전송 없음·API 키 불필요 — 모든 처리는 설치한 컴퓨터 안에서 끝납니다.

결과물은 초안입니다. 한글에서 확인한 뒤 쓰세요. 이 서버는 원고를 외부로 보내지 않습니다.

설치

Claude Code — 한 줄: claude mcp add korean-report-hwpx -- uvx korean-report-hwpx

Claude 앱(데스크톱·코워크) — 3단계

  1. uv 설치 (한 번만) — 맥은 터미널에, 윈도는 PowerShell에 붙여 넣습니다.
  • 맥: curl -LsSf https://astral.sh/uv/install.sh | sh
  • 윈도: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  1. Claude 앱 설정 → 개발자(Developer) → 구성 편집(Edit Config) 으로 열린 claude_desktop_config.json에 아래 mcpServers 내용을 넣고 저장합니다. 앱이 uvx를 못 찾으면 command에 전체 경로를 씁니다(맥 터미널에서 which uvx로 확인, 예: /Users/이름/.local/bin/uvx).
  2. Claude 앱을 완전히 종료했다가 다시 열고 "이 메모를 1쪽 보고서로 만들어 줘"라고 요청합니다.
{

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

  • API 키·환경변수 필요 없음. 만든 파일은 ~/korean-report-hwpx/에 저장됩니다(KOREAN_REPORT_HWPX_OUT_DIR로 변경, 이전 이름 KOREAN_GOV_DOCS_OUT_DIR도 인식).
  • 윈도에서 쓰기: docs/WINDOWS.md

이렇게 동작합니다

flowchart LR

M["메모·초안·사실관계"] --> AI["사용자 AI Claude·ChatGPT 등"] T["korean-tax-mcp·korean-tax-calc-mcp 세법 근거·계산 결과"] -.->|검토 보고서| AI AI --> G["get_writing_guide 작성 규칙·구조 스키마"] AI -.->|보도자료| P["draft_press_structure 사실 메모 → 구조 초안"] G --> J["구조 JSON"] P --> J J --> C["check_structure 점검·target_pages 분량"] C --> B["build_document 기관 서식 HWPX"] B -->|warnings| J R[("기관 규칙값 52곳 list_ministries·get_rules")] -.-> B B --> O["~/korean-report-hwpx/ .hwpx + 구조 .json + 간소화 .md"]

세법 MCP(korean-tax-mcp·korean-tax-calc-mcp)와 함께 쓰면 근거 찾기 → 계산 → 검토 보고서 HWPX까지 이어집니다.

이렇게 물어보세요

AI에게 평소처럼 말하면 됩니다. 도구 이름을 몰라도 됩니다.

이렇게 말하면이렇게 나옵니다
"어제 회의 결과를 과장님께 보고할 1쪽짜리 보고서로 만들어 줘"본문 1쪽을 꽉 채우고 세부는 붙임으로. 넘치거나 덜 차면 target_pages 경고대로 AI가 다시 만듦
"이 메모를 ○○부 보고서로 만들어 줘"42개 기관 보고서 서식(기관을 말하지 않으면 공통 서식)
"내부 결재용으로 만들어 줘"내부 결재 보고서 서식('26. 11. 8.(일) / 과명, 쪽 번호 "- n -")
"번호 매기는 간소화 양식으로, 마크다운도 같이"Ⅰ. 1. 가. 번호 서식 + .md 파일
"이 원고 국세청 보도자료로 만들어 줘, 보도시점 2026. 10. 8.(목) 조간"52개 기관 보도자료 서식, 리드·제목·인용·숫자 표기 점검
"이 보고서 결재 올릴 기안문 만들어 줘, 붙임은 방금 보고서"기안문(별지 제1호서식), 항목 번호·결재란·"끝." 자동
"아까 보고서에서 Ⅲ장 □ 문장만 바꿔서 다시 만들어 줘"파일 옆에 저장된 구조(.json)를 고쳐 다시 생성
"산림청 보고서 서식 규칙 보여 줘"계층별 기호·글꼴·크기·빈 줄 규칙값

검토서·추진계획·회의 결과·현황 보고는 모두 보고서로 만듭니다. 같은 자료로 보고서 → 보도자료 → 기안문을 이어서 만들 수도 있습니다.

링크

English README · llms.txt · CHANGELOG · PyPI · 소개 페이지 · 짝 서버 korean-tax-mcp·korean-tax-calc-mcp

⭐ 써 보시고 도움이 되셨다면 별 하나 눌러 주세요. 무료 공개를 계속 이어 가는 힘이 됩니다.


도구 (7개)

도구하는 일
get_writing_guide문서 종류 판단 기준, 작성 규칙(□ 두괄식 한 문장·ㅇ 근거·- 세부, 명사형 종결, 사실·숫자 창작 금지, 기호는 텍스트에 넣지 않음, 참고·붙임 구조, 기안문 항목 번호·날짜·금액·끝 표시·붙임), 구조 JSON 스키마·예시. MCP prompt writing_guide로도 제공
draft_press_structure사실 메모(누가·언제·무엇, 배경·핵심 내용·계획, 인용, 담당 부서, 숫자 등)를 보도자료 구조 JSON 초안으로 옮긴다. 메모에 없는 문장·숫자·이름을 만들지 않으며, 리드·인용·표·참고 자료를 규칙에 맞게 배치한다
check_structure생성 전 점검: 필수 필드, text 속 기호, 계층 건너뜀, □ 두 문장 이상, 명사형 종결 아닌 문장, 긴 제목, target_pages 분량, 기안문은 필수 키·to·disclosure 허용값·결재란 drafter/approver 필수·attachments 문자열 목록 검증
build_document구조 JSON → 기관 서식 HWPX. 입력 정규화(기호·대시·앞 공백 제거) + 고칠 점(warnings) 반환. 기안문은 doc_type="official", 금액 한글 병기 경고·날짜 정규화 포함
build_from_structurebuild_document의 별칭(이전 이름, 인자 같음)
list_ministries지원 기관과 문서 종류별 지원 여부(보고서: 기관 규칙/공통 규칙, 보도자료: 본문 방식, 기안문: 공통 서식)
get_rules기관·문서 종류별 서식 규칙값(계층별 기호·글꼴·크기·내어쓰기·빈 줄, 제목 상자·표 머리, 기안문은 rules_official/_공통.json)

보고서가 이렇게 나옵니다 (서식 기능)

기능내용
개조식 계층소제목(Ⅰ. Ⅱ.) → □ 결론 한 문장 → ㅇ 근거 → - 세부 → * 각주, ※ 참고. 기호·들여쓰기·글꼴은 기관 규칙값
강조·각주**핵심 문구**는 굵게, 문장 속 *·**는 위첨자 각주 표시
붙임 표시문장 끝 "붙임 1"·"참고 2"는 상자로 표시하고, 붙임·참고는 새 쪽에서 머리 표로 시작
표위아래 굵은 선, 머리행 아래 이중선, 머리행 옅은 음영, 좌우 바깥선 없음. 한 줄짜리 열은 가운데 정렬. 쪽을 넘으면 머리행 반복
분량 점검목표 쪽수(target_pages)를 주면 본문 쪽수·마지막 쪽 채움을 재서 넘침·덜 참·붙임 없음을 경고
1쪽 보고서 규칙"첫 장이 보고의 전부" — 개요는 표, □는 한 문장 압축, 되묻지 않게 꽉 채우고 세부는 붙임(작성 가이드에 포함)
자간 맞춤문단마다 자간·장평을 골라 마지막 줄에 한두 글자만 남지 않게. 맥+한글이 있으면 polish=True로 실제 줄 배치에 맞춰 다듬기
서식 세 가지표준 · 내부 결재(report_kind="internal") · 간소화(style="simplified", 마크다운 동시 출력)

문서 종류·분량 점검

종류구성기관 지정규칙
보고서(개조식)제목 상자, 작성일·작성부서 줄(선택), 소제목(Ⅰ. Ⅱ.) → □ → ㅇ → - → *, ※ 참고, 굵게·각주, 표, 붙임 표시 상자, 붙임·참고 쪽, 분량 점검선택 — 42개 기관 규칙, 그 외·미지정은 공통 규칙rules_report/ (보도자료 참고·붙임 구간 1,326건)
보도자료표지(로고 자리·보도자료), 보도시점·배포, 제목·부제, 본문(문단식/□식), 담당 표, 참고 쪽필수 — 52개 기관rules/·templates/ (보도자료 2,670건)
기안문·시행문(별지 제1호서식)두문·본문·결문, 항목 번호(1.→가.→1)→가)→(1)→(가)) 자동, 붙임, "끝." 표시, 결재란(표), 협조자, 시행/접수, 주소·연락처·공개구분기관 지정 없이 공통 서식(rules_official/_공통.json)rules_official/_공통.json (행정업무규정 제7조·시행규칙 제2·4·6조)

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

분량 점검: 사용자가 "1쪽으로", "3쪽 이내로"처럼 분량을 말하면 AI가 target_pages로 넘기고, 도구는 본문 쪽수·마지막 쪽 채움을 예측해 목표를 넘거나 덜 차거나(80% 미만) 붙임이 없으면 경고합니다. 분량을 말하지 않으면 쪽수 제한 없이 만듭니다. 예측은 실제로 만들 문서를 한글 배치 규칙(외톨이줄 보호, 소제목은 다음 문단과 같은 쪽, 표는 행 단위로 나누고 머리행 반복)대로 쌓아 계산합니다. 맥 한컴오피스 한글로 실측한 54개 문서(1–6쪽, 표준·내부 결재·간소화)에서 쪽수가 모두 맞았습니다.

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

보도자료 작성 방법과 사실 메모 예시

get_writing_guide(doc_type='press_release', ministry=기관)을 호출하면 보도자료 작성 방법(리드·제목·인용·숫자·쉬운 말)과 사실 메모 양식, 기관별 가상 예시를 함께 제공한다. 근거는 국립국어원 보도자료 작성 지침과 정책브리핑 보도자료 2,667건 실측이다(수집 2,670건 중 본문 실측에 쓴 2,667건).

사실 메모 예시(과학기술정보통신부 가상 사례):

{

"kind": "보도자료", "ministry": "과학기술정보통신부", "release": "2026. 11. 4.(수) 조간", "headline": "어르신 디지털 배움터 키오스크 교육 4,820명 수료", "subtitles": ["교육장 37곳 운영 결과, 수료생 만족도 92.4%"], "who": "과학기술정보통신부(장관 ○○○)", "when": "11월 3일(화)", "what": "올해 어르신 디지털 배움터 키오스크 교육 운영 결과를 발표했다", "points": ["3월부터 10월까지 전국 교육장 37곳에서 어르신 4,820명이 교육을 마쳤다."], "numbers": [{"item": "수료 인원", "value": "4,820", "unit": "명", "basis": "2026. 3.~10."}], "quote": {"speaker": "○○○ 과학기술정보통신부 장관", "text": ["어르신 누구나 무인 기기를 불편 없이 쓸 수 있도록 가까운 곳에서 배울 기회를 넓히겠다."], "verb": "말했다"}, "contact": {"dept": "과학기술정보통신부 디지털포용정책과", "people": [["책임자", "과장", "○○○", "(044-202-0000)"]]} }

이후 draft_press_structure(facts, ministry) → 구조 JSON 초안 + missing·warnings → 문장 다듬기 → check_structure(structure, 'press_release', ministry=기관) → build_document(structure, 'press_release', 기관).

출처:

  • 국립국어원, 『유형별로 알아보는 보도자료 작성 길잡이』(2020) — G20
  • 국립국어원, 『보도자료 유형별 표준안 개발』(2020) — R20
  • 국립국어원, 『보도 자료 쓰기 길잡이』(2011) — G11
  • 국립국어원, 『개정판 한눈에 알아보는 공공언어 바로 쓰기』(2022) — H22
  • 문화체육관광부·국립국어원, 『쉬운 공공언어 쓰기 길잡이』(2014) — E14
  • 정책브리핑(korea.kr) 보도자료 2,667건 본문 실측(52개 중앙행정기관) — C

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

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

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

간소화 모드 특징:

  • 항목 기호(□ ㅇ ○ - * ※) 대신 단계별 번호 자동 부여: Ⅰ. Ⅱ. Ⅲ. (소제목) → 1. 2. 3. (대항목) → 가. 나. 다. (중항목) → 1) 2) 3) (소항목) → 가) 나) 다) (세항목)
  • 번호는 서버가 구조 JSON의 계층 수준(level)에서 계산하므로 사용자가 직접 번호를 쓰지 않음
  • 단계별 들여쓰기 유지
  • 서술식 문장 허용 (~합니다·~했다 등 동사형 종결 가능, 명사형 종결 경고 없음)
  • 제목 상자(테두리·음영) 없이 일반 제목 문단
  • 표 머리 음영 없음
  • 표 제목 자동 번호: 〈표 1〉 제목 형식 (caption에는 제목만 작성)
  • 표 셀 병합 금지: 구조에 병합이 있으면 같은 값이 행마다 반복되도록 풀어 씀
  • export_markdown=True: 같은 구조로 .md 파일 동시 저장 (GFM 표, #, ##, ### 제목 위계)
  • 줄 간격 150%, 문단 위 10pt(1수준)·5pt(그 외), 빈 줄 없이 문단 간격으로 구분
  • 번호는 글자로 넣음. 한글 '개요' 번호 연동은 다음 버전 예정

내부 결재 보고서 (report_kind="internal")

정보공개포털 내부 결재 보고서 실물 표본 측정값 반영: 라벨 칸 없는 제목, 작성일·부서 줄 '26. 10. 9.(금) / 과·팀명, 줄 간격 150%, 문단 위 10pt(□)·5pt(ㅇ·-).

예시:

{

"title": "○○ 추진계획(안)", "date": "2026. 10. 7.", "dept": "○○과", "body": [ {"type": "h", "text": "추진 배경"}, {"type": "l1", "text": "민원 대기 시간 감소를 위해 AI 안내 도입 필요"}, {"type": "l2", "text": "하루 평균 창구 민원 약 400건"}, {"type": "caption", "text": "소요 예산"}, {"type": "table", "rows": [["구분", "금액"], ["시스템 구축", "2억"]]} ] }

→ 간소화 모드로 생성 시: `Ⅰ. 추진 배경`, `1. 민원 대기 시간 감소를 위해 AI 안내 도입 필요`, `가. 하루 평균 창구 민원 약 400건`, `〈표 1〉 소요 예산` 형식으로 표시.

구조 JSON 예 — 보고서·보도자료·기안문

보고서 구조 JSON 예:

{

"title": "○○ 서비스 도입 추진계획(안)", "date": "2026. 10. 7.", "dept": "○○과", "body": [{"type": "h", "text": "Ⅰ. 추진 배경"}, {"type": "l1", "text": "핵심 결론 한 문장임"}, {"type": "l2", "text": "근거·세부"}, {"type": "l3", "text": "소항목"}, {"type": "note", "text": "각주"}, {"type": "ref", "text": "참고 사항"}, {"type": "caption", "text": "소요 예산"}, {"type": "table", "rows": [["구분", "금액"], ["가", "100"]]}], "appendix": [{"title": "붙임 1", "heading": "세부 내용", "body": [{"type": "l1", "text": "..."}]}] }

보도자료 구조는 {release, distribute, title, subtitles, body, appendix, contact}입니다(블록 종류는 같고 문단 p·강조 상자 box·그림 image 추가). 원고에 담당자가 없으면 담당 표를 ○○과 / 김○○ / 044-000-0000 자리표시로 채웁니다(placeholder_contact).

기안문·시행문(별지 제1호서식) 구조는 doc_type="official"로 요청합니다. 구조:

{

"org": "행정안전부", // 두문 행정기관명(필수). 상급기관 병기는 "국무조정실 ○○위원회"처럼 한 줄 "to": "수신자 참조", // 필수. "내부결재" | "○○장관(○○과장)" | "수신자 참조" "via": "", // 경유(선택). 있으면 "(경유)" 줄에 표시 "title": "2026년 ○○ 계획 알림", // 필수 "body": [ // 항목 번호(1.→가.→1)→가)→(1)→(가))는 서버가 부여 {"type": "l1", "text": "..."}, {"type": "l2", "text": "..."}, {"type": "l3", "text": "..."}, {"type": "table", "rows": [[...]]}, {"type": "lines", "lines": ["..."]} ], "attachments": ["○○ 계획서 1부.", "○○ 명단 1부."], // 선택 "recipients": ["○○부장관", "○○청장"], // to="수신자 참조"일 때 결문 발신 명의 다음 줄 "sender": "행정안전부장관", // 발신 명의(필수) "approval": { // 결재란(필수: drafter·approver) "drafter": {"title": "주무관", "name": "", "mark": "★"}, "reviewers": [{"title": "과장", "name": "", "opinion": false}], "approver": {"title": "국장", "name": ""}, "coordinators": [{"title": "○○과장"}] }, "doc_no": {"issue": "○○과-1234", "issue_date": "2026. 10. 14.", "receive": "", "receive_date": ""}, "contact": {"zip": "30112", "address": "세종특별자

Only the beginning is shown; read the rest in the repo