Kordoc

社区

将韩国办公文档（HWP・HWPX・PDF・Office）转换为 Markdown 的 CLI 和 MCP 服务器，支持表单填充与文档对比。

分类: 其他
Stars: ★ 2.4k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 无需凭据
许可证: MIT
最近提交: 1 天前
工具数: 15

59FMRS · C

Kordoc 是一款功能强大的文档处理工具，尤其擅长处理韩国政府文档。它提供了广泛的格式支持、丰富的 MCP 工具和高度的可定制性。对于需要自动化处理韩国文档的 AI 工作流，它是一个可靠的选择，但需注意其名称和文档语言可能不适合非韩语用户。

最强项 · 文档质量 14/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

11/20

维护活跃度

13/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 9/20: 这是一个功能丰富的MCP服务器，宣称支持HWP、HWPX、PDF等格式解析和Markdown转换。但静态审查无法验证MCP握手或工具声明是否与实际行为一致，因为仓库中未见MCP服务器测试或CI运行的明确证据。README详细列出了15个工具和常见问题，但缺少可复现的测试用例或CI配置来证明关键路径。可靠性得分上限为12，鉴于缺乏可执行的验证证据，给予9分。
安全与权限 11/20: 无恶意代码或凭据泄露的红线迹象。README中提到了多项安全防护措施，如ZIP炸弹防护、路径遍历阻断、SSRF阻止等，但无法静态确认其实现是否有效。存在PDF、ZIP等格式解析，潜在攻击面较大。另外，PDF OCR功能会下载外部模型，但支持KORDOC_OFFLINE和KORDOC_ROOT环境变量来限制网络和文件访问，显示出一定的安全考量。由于权限和确认机制未明确，且数据边界主要依赖可选环境变量，给予11分。
维护活跃度 13/20: 仓库活跃，近期的v4.7.2发布，且没有归档。大量Stars（1672）表明社区关注度高，但按规则Stars不计分。有MIT许可证，CHANGELOG详尽，但未看到明确的依赖更新策略或安全响应渠道。维护活跃但治理层面有缺口，例如未展示明确的贡献指南或安全公告，因此给予13分。
文档质量 14/20: 文档非常详尽，涵盖安装、CLI、API、MCP配置、使用示例和变更日志。但缺少针对MCP服务器本身的专门故障排除指南，以及工具参数的完整说明。存在部分隐藏假设，如依赖Node.js 18+，未明确不同操作系统的兼容性细节。文档质量高但有小幅遗漏，给予14分。
安装易用性 12/20: 通过npx kordoc setup提供了交互式安装向导，支持多种AI客户端，并提供了手动配置示例。安装步骤清晰，但依赖npx和Node.js，未提及版本兼容性问题。由于未能验证实际安装过程，且无CI证据，根据指导原则setup上限15分，给予12分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络

适合谁

需要处理韩国官方文档（HWP、HWPX 等）的开发者或团队。
在 AI 辅助工作流中需要解析和生成公文文档的用户。
处理大量韩国政府或公共部门文档的自动化任务。

不适合谁

需要处理非韩国文档格式（如纯英文 Office 文档）的用户，虽然支持但非重点优化。
不需要文档转换或强调文档处理的通用 MCP 使用场景。

所需权限

读取和写入本地文件（文档解析、生成、补丁操作）。
网络访问：首次使用时自动下载 OCR 模型（约 18MB）。
可能读取图像（PNG/JPG/WebP）以进行 OCR。

风险与副作用

处理不受信任的文件可能存在安全风险，但项目已包含安全防护措施，如 ZIP 炸弹防护、XXE 防护等。
OCR 模型下载需要网络，可能在离线环境失败。
错误的文档解析可能导致数据丢失，建议在重要文档上先进行验证。

安装接入

准备工作

运行环境：Node.js 18+

其他可选配置项（2 个）

KORDOC_OFFLINE 可选设为 1 时阻断所有出站请求（如 OCR 模型下载、watch webhook），用于内网部署；可选，不设则默认行为不变。

KORDOC_ROOT 可选设为某个目录时，MCP 服务器的文件读写被限制在该目录之内；可选，不设则不限制。

确保已安装 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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "kordoc": {
      "command": "npx",
      "args": [
        "-y",
        "kordoc",
        "mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add kordoc -- npx -y kordoc mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端中运行 `npx -y kordoc setup`（或手动添加 mcpServers 配置）并重启后，检查工具列表中是否出现 parse_document、fill_form、generate_document 等工具；也可以直接发送 '把这个 .hwpx 文件解析成 Markdown'，若返回 Markdown 内容即说明连接成功。

常见排障

如果 `npx -y kordoc setup` 在 Windows 上失败，请使用命令提示符（cmd）而不是 PowerShell，或设置执行策略为 RemoteSigned。
如果遇到 `MODULE_NOT_FOUND`，请先运行 `npm uninstall -g kordoc`，然后重新执行安装。
如果 PDF 解析结果乱码，尝试启用 OCR：在 MCP 调用中使用 `ocr: true` 参数。
对于损坏的 HWP 文件，Kordoc 可能无法修复，请确保原始文件未损坏。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把这个 HWPX 文件解析成 Markdown，并告诉我里面有哪些表格。
对比这两份文档，生成新旧对照表。
用内置的 gian（一般公文）模板帮我填写这份申请书的空白字段。
把我编辑过的 Markdown 改动应用回原始 HWPX 文件，保留原有格式。

工具能力 15

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 格式，并包含完整性保护。

展开其余 7 个工具

patch_document 写入

将编辑后的 Markdown 补丁应用到原始 HWPX 或 HWP 文件，保留格式。

extract_profile 只读

从参考 HWPX 文件中提取表格格式配置文件，用于生成文档时复用。

generate_document 写入

从 Markdown（包括表格、公式和图表）生成 HWPX 文件，支持公文预设。

place_seal 写入

将印章或签名图片放置在锚文本上方，实现自动盖章。

render_document 只读

将 HWPX 渲染为 PNG 或 SVG，保留原始布局，支持多页和搜索高亮。

redact_document 写入

检测并遮蔽个人身份信息（如身份证号、电话、邮箱、银行卡等），保留原始格式。

parse_chunks 只读

为 RAG 生成结构化文本块，保留标题和层级信息。

使用场景

将韩国政府办公室的文档（如 .hwp、.hwpx）转换为 Markdown，以便 AI 处理。

自动填写官方表格和公文，如工作报告、计划等。

对比文档版本，生成新增、删除或修改内容的差异报告。

将 AI 生成的 Markdown 转换回标准格式的 HWPX 公文。

对包含个人信息的文档进行脱敏处理。

支持客户端

Claude Desktop

Cursor

Windsurf

Claude Code

VS Code

Gemini CLI

Zed

Codex

依据项目文档列出，未经本站实测。

详细介绍

Kordoc 是一款专注于韩国官方文档处理的 CLI 和 MCP 服务器，能够解析 HWP 3.x/5.x、HWPX、HWPML、PDF、XLS、XLSX、DOCX 以及图像（PNG/JPG/WebP）并转换为 Markdown。它提供表单填充、文档对比、格式保留的修补、Markdown 生成 HWPX、个人数据脱敏等功能。由一位曾在前韩国区政府工作的公务员开发，基于真实政府文档进行了广泛测试。