韩文公文校对工具

GongMun Doctor MCP是一款在本地PC上自动校对韩文公文(.hwpx/.hwp)的MCP服务器,无需网络连接或云API密钥,确保文档安全。

  • by sinmb79
  • Python
  • 本地部署
  • 24 星标
  • 更新于
在 GitHub 查看 sinmb79/GongMun-Doctor-MCP

使用说明

金门医生MCP

AI在本地安全地校对公文 基于人工智能的韩国官方文档校对——100%本地,无需云端


简介| Introduction

GongMun Doctor MCP将韩国公文(.hwpx/.hwp) 在本地PC上 自动校准的MCP服务器。如果您对Claude、Codex等AI代理说“请更正此文档”,则该文件将在我的PC上完成更正,而不会外部显示。

GongMun Doctor MCP是一个本地MCP服务器,完全在您的PC上校对韩国官方文件(.hwpx/.hwp)。当您要求像Claude或Codex这样的人工智能代理“校对此文件”时,文件永远不会离开您的计算机。

安全原则Security First:文档不出去。无网络呼叫。无需云API密钥。 文件保留在本地。没有网络呼叫。不需要云API密钥。


对这些人有用Who Is This For?

目标 使用示例
公务员 起草方案后自动更正拼写/公文字体,报告前最终验收
公共机关职员 自动生成工作协助请求、信访回复等公文模板
行政司/法务司 批量文档校准,自动生成校准报告
第一次写公文的人 通过50种管理文档模板学习正确的表单
谁 用例
政府官员 提交前自动校对草稿
公共机构工作人员 生成官方文件模板(合作请求、民事回复等)
行政专业人员 使用报告批量更正大量文档
初学者 使用50个内置模板学习正确的官方文档格式

关键功能| Key Features

三层校正规则|三层校正规则

图层Layer 内容Description 示例Example
L1拼写 分写法、拼写纠正 “执行通知”->“执行通知”
L2语法 调查错误,删除兵器 “乙/乙”“->”(公文禁止调查兵器)
L3公文字体 纠正行政业务运营手册标准格式 “关于”、“关于”(连接表示后省略逗号)

10个MCP工具| 10个MCP工具

“工具工具”“说明Description” |---|-----------|-----------------| | 1 | correct_document |单文档校正/Correct one document | | 2 | correct_documents_in_folder |文件夹中的文档批处理/Batch correct all documents in a folder | | 3 | list_rules 查询校准规则列表/List correction rules | 4 | get_correction_report |查看校准报告/Read correction report| | 5 | preview_text_corrections |预览文本校正/Preview corrections without touching files | | 6 | list_document_templates |行政文档模板列表/List document templates | | 7 | match_document_templates |按关键字搜索模板/Search templates by keyword | | 8 | get_template_variables |查询模板输入变量/Show required template variables| | 9 | render_document_template |呈现模板(生成文档)/Render template with values | 10 | get_server_info |查询服务器信息/Server info|

50种管理文档模板| 50 Administrative Templates

在六个领域提供可直接在实践中使用的模板:

领域类别 模板数量 示例Examples
一般行政 (gen)15种工作协助请求、通知通知、回复、工作报告、资料请求、会议召开通知等
感谢 (audit)5种审计结果通报、纠正措施要求、指导检查通知等
信访 (civil)5种信访回复、延长处理时间通报、转发通报、质疑回复等
建设工程 (con)10种 开工通知、竣工通知、设计变更请求、瑕疵维修通知等
问候 (hr)5种出差结果报告、休假使用报告、兼职许可申请、职位解除通知等
合同采购 (proc)10种招标公告、中标人决定通报、合同签订请求、补助金交付申请等

快速入门指南|快速入门指南

步骤1:安装步骤1:Install

python 3.12或3.13建议。在3.14中 lxml 可能会出现构建问题。 python 3.12或3.13 推荐。3.14可能有 lxml 构建问题。

# 저장소 클론 | Clone the repository
git clone https://github.com/sinmb79/GongMun-Doctor-MCP.git
cd GongMun-Doctor-MCP

# MCP 라이브러리 설치 | Install MCP library
python -m pip install "mcp[cli]>=1.0,<2"

# GongMun Doctor 설치 (개발 모드) | Install in dev mode
python -m pip install -e . --no-deps

步骤2:验证服务器运行|步骤2:Verify Server

# 서버 직접 실행 | Run server directly
python -m gongmun_doctor.mcp.server

# MCP Inspector로 도구 목록 확인 (선택) | Inspect tools visually (optional)
npx -y @modelcontextprotocol/inspector python -m gongmun_doctor.mcp.server

步骤3:AI客户端连接|步骤3:Connect Your AI客户端

Codex(最简单| Simplest)

codex mcp add gongmun-doctor -- python -m gongmun_doctor.mcp.server

确认:

codex mcp list

克劳德代码

claude mcp add --transport stdio gongmun-doctor -- python -m gongmun_doctor.mcp.server

按项目单位设置的步骤 .mcp.json请使用。有关详细信息,请访问 docs/client-setup-ko.md请参考。

克劳德桌面版

手动stdio连接示例 examples/claude_desktop_config json请参考。


实战使用示例| Real-World Usage Examples

连接AI代理后,用自然语言请求即可。无需记住工具名称。

连接到您的AI代理后,只需用自然语言提问。无需记住工具名称。

示例1:校正单个文档Example 1:Correct One Document

请这样说| Say this:

D:\문서\공문.hwpx를 dry_run으로 먼저 검사해줘

AI执行的任务| What happens:

correct_document(file_path="D:\\문서\\공문.hwpx", dry_run=True) 呼叫

{
  "status": "dry_run_complete",
  "file_path": "D:\\문서\\공문.hwpx",
  "corrections": [
    {"rule": "SP-001", "layer": "L1_spelling", "before": "시행알림", "after": "시행 알림"},
    {"rule": "GR-001", "layer": "L2_grammar", "before": "을/를", "after": "을"},
    {"rule": "OS-002", "layer": "L3_official_style", "before": "관련 :", "after": "관련:"}
  ],
  "total_corrections": 3
}

检查校对后实际应用:

확인했어. 실제로 교정해줘.

示例2:Example 2:Batch Correct a Folder

D:\문서\주간보고 폴더 안의 .hwpx를 전부 교정하고 보고서도 만들어줘

correct_documents_in_folder(folder_path="D:\\문서\\주간보고", report=True) 调用--校对文件夹中的所有.hwpx文件并生成每个校对报告(Markdown)。

示例3:检查校对规则| Example 3:Check Rules

맞춤법 레이어 규칙만 보여줘

list_rules(layer="L1_spelling") 呼叫:

[
  {"id": "SP-001", "search": "시행알림", "replace": "시행 알림", "desc": "합성어가 아닌 경우 띄어쓰기"},
  {"id": "SP-002", "search": "참고 하시기", "replace": "참고하시기", "desc": "'참고하다'는 한 단어이므로 붙여 씀"},
  {"id": "SP-003", "search": "보수 공사", "replace": "보수공사", "desc": "'보수공사'는 한 단어이므로 붙여 씀"}
]

示例4:使用公文模板创建文档| Example 4:Generate Document from Template

업무 협조 요청 공문을 만들어줘

AI会自动查找合适的模板,询问所需信息,然后生成文档:

수신기관: ○○시 도시건설국장
제목: 도시계획 변경 관련 업무 협조 요청
관련문서: 도시계획과-1234(2026.03.10.)
협조사항: 도시계획 변경안 검토
기한: 2026. 4. 10.

生成结果| Output:

수신 ○○시 도시건설국장
(경유)
제목 도시계획 변경 관련 업무 협조 요청

1. 관련: 도시계획과-1234(2026.03.10.)

2. 위 호와 관련하여 도시계획 변경안 검토에 대한 귀 기관의
   적극적인 협조를 요청합니다.

3. 협조 요청 사항은 다음과 같습니다.
   가. 협조 내용: 도시계획 변경안 검토
   나. 회신 기한: 2026. 4. 10.까지
   다. 담당자: 도시계획과 담당자 홍길동

붙임 협조 요청 자료 1부.  끝.

示例5:文本预览| Example 5:Preview Text Corrections

"관련하여, 을/를 첨부 합니다" 이 문장 교정해줘

preview_text_corrections(text="관련하여, 을/를 첨부 합니다") 调用--无需文件,只需文本即可预览校准结果。


项目结构Project Structure

GongMun-Doctor-MCP/
|-- src/gongmun_doctor/
|   |-- mcp/                   # MCP 서버 | MCP server
|   |   |-- server.py           #   서버 정의 (10개 도구)
|   |   |-- services.py         #   비즈니스 로직
|   |   +-- models.py           #   데이터 모델
|   |-- rules/                  # 교정 규칙 | Correction rules
|   |   |-- L1_spelling.json    #   맞춤법/띄어쓰기
|   |   |-- L2_grammar.json     #   문법 (조사 오류 등)
|   |   +-- L3_official_style.json  #   공문서체
|   |-- agents/administrative/  # 행정문서 템플릿 | Templates
|   |   +-- templates/          #   50종 JSON 템플릿
|   |-- parser/                 # HWPX/HWP 파서 | Document parser
|   |-- engine.py               # 교정 엔진 | Correction engine
|   +-- report/                 # 보고서 생성 | Report generator
|-- docs/                       # 설정 가이드 | Setup guides
|-- examples/                   # 클라이언트 설정 예시 | Client config examples
+-- tests/                      # 테스트 | Tests

常见问题解答FAQ

服务器显示了,但无法校正文件。

MCP服务器的运行与文档校对无关。实际 .hwpx 文档校对包括: python-hwpx 需要运行时:

python -m pip install "python-hwpx>=2.8.0"

我在Windows上找不到命令。

python, codex, claude 如果命令不在PATH中。请使用完整路径:

# 예시: Python 전체 경로
C:\Users\사용자\AppData\Local\Programs\Python\Python312\python.exe -m gongmun_doctor.mcp.server

Claude Code显示批准弹出窗口

正常动作。 .mcp.json 基础项目服务器在首次使用时需要经过批准。

Claude Desktop无法连接

目前的主要支持对象是Codex和Claude Code。Claude Desktop可以通过手动stdio连接,但可能会因环境而异。


运行测试| Running Tests

pytest tests -q

需要实际HWPX文件的集成测试通过单独的标记进行管理:

# 통합 테스트 제외 | Skip integration tests
pytest tests -q -m "not integration"

安全设计原则Security Design Principles

原则Principle 说明Description
本地优先 所有文件处理都在您的PC上完成
无网络 默认行为没有网络调用
无需API密钥 无需云API密钥即可启动
边界清晰 明确区分本地处理和外部通信的界限

云LLM分析、韩文COM自动操作等扩展是可选的(opt-in),不在默认范围内。 Cloud LLM分析和HWP COM自动化是可选扩展,不包含在默认范围内。


参考文档References


许可证

MIT许可证--可自由使用、修改和分发。

MIT许可证——免费使用、修改和分发。


创建者Author

22B实验室 (sinmb79)——第四条道路

咨询或贡献 问题请使用。

如有疑问或投稿,请使用 问题.