适合谁
- 需要处理韩国官方文档（HWP、HWPX 等）的开发者或团队。
- 在 AI 辅助工作流中需要解析和生成公文文档的用户。
- 处理大量韩国政府或公共部门文档的自动化任务。
K
59FMRS · C
Kordoc 是一款功能强大的文档处理工具，尤其擅长处理韩国政府文档。它提供了广泛的格式支持、丰富的 MCP 工具和高度的可定制性。对于需要自动化处理韩国文档的 AI 工作流，它是一个可靠的选择，但需注意其名称和文档语言可能不适合非韩语用户。
Kordoc 是一款专注于韩国官方文档处理的 CLI 和 MCP 服务器，能够解析 HWP 3.x/5.x、HWPX、HWPML、PDF、XLS、XLSX、DOCX 以及图像（PNG/JPG/WebP）并转换为 Markdown。它提供表单填充、文档对比、格式保留的修补、Markdown 生成 HWPX、个人数据脱敏等功能。由一位曾在前韩国区政府工作的公务员开发，基于真实政府文档进行了广泛测试。
工具能力
parse_document
将 HWP/HWPX/PDF/XLSX/DOCX 等文档解析为 Markdown 并包含元数据。
detect_format
通过魔数检测文件格式。
parse_metadata
仅提取文档的元数据。
parse_pages
解析文档的指定页面范围。
parse_table
提取文档中的第 N 个表格。
compare_documents
对比两个文档，支持跨格式比较并生成差异报告。
parse_form
从文档中提取表单字段为 JSON。
fill_form
填充表单模板中的值，保留原始 HWPX 格式，并包含完整性保护。
patch_document
将编辑后的 Markdown 补丁应用到原始 HWPX 或 HWP 文件，保留格式。
extract_profile
从参考 HWPX 文件中提取表格格式配置文件，用于生成文档时复用。
generate_document
从 Markdown（包括表格、公式和图表）生成 HWPX 文件，支持公文预设。
place_seal
将印章或签名图片放置在锚文本上方，实现自动盖章。
render_document
将 HWPX 渲染为 PNG 或 SVG，保留原始布局，支持多页和搜索高亮。
redact_document
检测并遮蔽个人身份信息（如身份证号、电话、邮箱、银行卡等），保留原始格式。
parse_chunks
为 RAG 生成结构化文本块，保留标题和层级信息。
安装接入
- 确保已安装 Node.js 18+。
- 运行
npx -y kordoc setup并选择您的 AI 客户端（自动配置）。 - 或者手动编辑 MCP 客户端配置文件，添加：
{"mcpServers":{"kordoc":{"command":"npx","args":["-y","kordoc","mcp"]}}}对于 Windows，可能需要使用 cmd /c npx 包装。
claude_desktop_config.json
{
"mcpServers": {
"kordoc": {
"command": "npx",
"args": [
"-y",
"kordoc",
"mcp"
]
}
}
}
选型与风险
不适合谁
- 需要处理非韩国文档格式（如纯英文 Office 文档）的用户，虽然支持但非重点优化。
- 不需要文档转换或强调文档处理的通用 MCP 使用场景。
所需权限
- 读取和写入本地文件（文档解析、生成、补丁操作）。
- 网络访问：首次使用时自动下载 OCR 模型（约 18MB）。
- 可能读取图像（PNG/JPG/WebP）以进行 OCR。
风险与副作用
- 处理不受信任的文件可能存在安全风险，但项目已包含安全防护措施，如 ZIP 炸弹防护、XXE 防护等。
- OCR 模型下载需要网络，可能在离线环境失败。
- 错误的文档解析可能导致数据丢失，建议在重要文档上先进行验证。
常见排障
- 如果 `npx -y kordoc setup` 在 Windows 上失败，请使用命令提示符（cmd）而不是 PowerShell，或设置执行策略为 RemoteSigned。
- 如果遇到 `MODULE_NOT_FOUND`，请先运行 `npm uninstall -g kordoc`，然后重新执行安装。
- 如果 PDF 解析结果乱码，尝试启用 OCR：在 MCP 调用中使用 `ocr: true` 参数。
- 对于损坏的 HWP 文件，Kordoc 可能无法修复，请确保原始文件未损坏。
使用场景
将韩国政府办公室的文档（如 .hwp、.hwpx）转换为 Markdown，以便 AI 处理。
自动填写官方表格和公文，如工作报告、计划等。
对比文档版本，生成新增、删除或修改内容的差异报告。
将 AI 生成的 Markdown 转换回标准格式的 HWPX 公文。
对包含个人信息的文档进行脱敏处理。
支持客户端
Claude Desktop完整支持
Cursor完整支持
Windsurf完整支持
Claude Code完整支持
VS Code完整支持
Gemini CLI完整支持
Zed完整支持
Codex完整支持