金门医生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.8.0"我在Windows上找不到命令。
python, codex, claude 如果命令不在PATH中。请使用完整路径：
# 예시: Python 전체 경로
C:\Users\사용자\AppData\Local\Programs\Python\Python312\python.exe -m gongmun_doctor.mcp.serverClaude 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）——第四条道路
咨询或贡献 问题请使用。
如有疑问或投稿，请使用 问题.