🏛 22B Labs · 공공행정 오픈소스
공문서 교정, 이제 AI한테 맡기세요 — 문서는 밖으로 안 나갑니다
공문닥터 MCP(GongMun Doctor MCP) — 로컬 완전 처리 공문서 교정·생성 MCP 서버 무료 공개
한국어 공문서·업무보고서·협조문을 쓰는 사람이라면 누구나 겪는 일이 있습니다. 다 쓰고 나서 맞춤법이 맞는지, 공문서체가 맞는지 한 번 더 확인하고 싶은데 일반 맞춤법 검사기는 공문서 특유의 표현을 모릅니다. 그렇다고 매번 선배나 동료에게 검토를 부탁하기도 어렵습니다.
공문닥터 MCP는 Claude나 Codex에 연결해서 쓰는 공문서 교정·생성 도구입니다. "이 공문 교정해줘"라고 말하는 것만으로 맞춤법·문법·공문서체 3단계 교정이 자동 적용됩니다. 공무원, 공공기관 직원, 행정사, 회사에서 공문 형식의 문서를 쓰는 모든 분이 대상입니다.
"한국어 공문서에는 공문서만의 문법이 있습니다.
일반 맞춤법 검사기가 모르는 것들을 교정합니다.
Claude·Codex에 연결해 대화하듯 쓰면 됩니다."
일반 맞춤법 검사기가 모르는 것들을 교정합니다.
Claude·Codex에 연결해 대화하듯 쓰면 됩니다."
how it works
작동 방식
⚙️ 구조
교정 규칙 엔진 — 로컬
맞춤법·문법·공문서체 규칙은 내 PC에서 실행
AI 클라이언트 — Claude / Codex
문서 내용은 연결된 AI 서비스로 전송됩니다
별도 API 키 불필요
공문닥터 자체에는 클라우드 키가 없음
50종 템플릿 — 로컬 내장
문서 생성 템플릿은 외부 연결 없이 동작
📌 참고 — 교정 시 문서 내용은 연결된 AI(Claude, Codex 등)의 서버로 전송됩니다. 민감한 내용이 포함된 문서는 해당 AI 서비스의 개인정보처리방침을 확인하세요.
correction layers
3단계 교정 규칙
일반 맞춤법 검사와 다릅니다. 공문서에는 공문서만의 문법이 있습니다. 3개 레이어가 순서대로 적용됩니다.
L1 · 맞춤법
띄어쓰기·맞춤법
일반 맞춤법 + 공문서 합성어 규칙
"시행알림" → "시행 알림"
L2 · 문법
조사 오류·병기
공문서는 조사 병기 금지
"을/를" → "을"
L3 · 공문서체
행정업무운영편람
공식 서식 기준 교정
"관련하여," → "관련하여"
templates
50종 행정문서 템플릿
공문서 형식의 문서를 쓰는 모든 분이 바로 활용할 수 있습니다. 공무원, 공공기관, 회사, 행정사, 처음 쓰는 분까지. 6개 분야 50종이 내장되어 있습니다.
📄 일반행정
15종
업무협조요청, 알림통보, 회신, 업무보고, 자료요청, 회의개최알림...
🔍 감사
5종
감사결과통보, 시정조치요구, 지도점검알림...
👤 민원
5종
민원회신, 처리기간연장통보, 이첩통보, 질의회신...
🏗 건설공사
10종
착공알림, 준공알림, 설계변경요청, 하자보수통보...
👔 인사
5종
출장결과보고, 휴가사용보고, 겸직허가신청...
📦 계약조달
10종
입찰공고, 낙찰자결정통보, 계약체결요청, 보조금교부신청...
usage
이렇게 씁니다 — 말로만
1
단일 문서 교정 — dry_run으로 먼저 확인
"D:\문서\공문.hwpx를 dry_run으로 먼저 검사해줘"
2
확인 후 실제 교정 적용
"확인했어. 실제로 교정해줘."
3
폴더 일괄 교정
"D:\문서\주간보고 폴더 안의 hwpx를 전부 교정하고 보고서도 만들어줘"
4
공문 템플릿으로 새 문서 생성
"업무 협조 요청 공문을 만들어줘" → AI가 템플릿 찾고 변수 물어본 뒤 완성
5
텍스트 즉석 교정 (파일 없이)
"관련하여, 을/를 첨부 합니다" 이 문장 교정해줘"
example output
실제 산출물 예시
# 업무협조 요청 공문 자동 생성 결과
수신 ○○시 도시건설국장
(경유)
제목 도시계획 변경 관련 업무 협조 요청
1. 관련: 도시계획과-1234(2026.03.10.)
2. 위 호와 관련하여 도시계획 변경안 검토에 대한 귀 기관의
적극적인 협조를 요청합니다.
3. 협조 요청 사항은 다음과 같습니다.
가. 협조 내용: 도시계획 변경안 검토
나. 회신 기한: 2026. 4. 10.까지
다. 담당자: 도시계획과 담당자 홍길동
붙임 협조 요청 자료 1부. 끝.
tools
10개 MCP 도구
| 도구 | 설명 |
|---|---|
correct_document | 단일 문서 교정 (.hwpx/.hwp) |
correct_documents_in_folder | 폴더 내 문서 일괄 교정 |
list_rules | 교정 규칙 목록 조회 |
get_correction_report | 교정 보고서 조회 |
preview_text_corrections | 텍스트 교정 미리보기 (파일 불필요) |
list_document_templates | 행정문서 템플릿 목록 조회 |
match_document_templates | 키워드로 템플릿 검색 |
get_template_variables | 템플릿 입력 변수 조회 |
render_document_template | 템플릿 렌더링 (문서 생성) |
get_server_info | 서버 정보 조회 |
installation
설치 방법
⚠️ Python 3.12 또는 3.13 권장 — 3.14에서는
lxml 빌드 문제가 발생할 수 있습니다.
# 1. 저장소 클론
git clone https://github.com/sinmb79/GongMun-Doctor-MCP.git
cd GongMun-Doctor-MCP
# 2. 의존성 설치
python -m pip install "mcp[cli]>=1.0,<2"
python -m pip install -e . --no-deps
# 3. 실제 HWPX 교정을 위한 런타임 설치
python -m pip install "python-hwpx>=2.8.0"
💡 Codex 연결 (가장 간단)
💡 Claude Code 연결
codex mcp add gongmun-doctor -- python -m gongmun_doctor.mcp.server💡 Claude Code 연결
claude mcp add --transport stdio gongmun-doctor -- python -m gongmun_doctor.mcp.server
faq
자주 묻는 질문
Q. 서버는 뜨는데 문서 교정이 안 돼요.
실제 .hwpx 교정에는 python-hwpx 런타임이 별도로 필요합니다.
pip install "python-hwpx>=2.8.0"을 실행해 주세요.Q. Claude Desktop에서 연결이 안 돼요.
현재 주력 지원 대상은 Codex와 Claude Code입니다. Claude Desktop은 수동 stdio 연결로 가능하며 examples/claude_desktop_config.json을 참고하세요.
Q. 공문서 내용이 AI 서버로 전송되나요?
기본 동작에서는 문서가 외부로 나가지 않습니다. 모든 교정은 로컬 PC에서 완료됩니다. 클라우드 LLM 분석은 선택 기능(opt-in)입니다.
Q. HWP도 지원하나요?
.hwpx와 .hwp 모두 지원합니다.
GitHub에서 바로 시작하세요
MIT 라이선스 · 완전 무료 · 10개 MCP 도구 · 50종 템플릿
Python 3.12+ · Codex / Claude Code / Claude Desktop 지원