使用说明
金门医生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)——第四条道路
咨询或贡献 问题请使用。
如有疑问或投稿,请使用 问题.
