HWP to Markdown

io.github.groove79由 GitHub 账号 groove79 发布v0.1.1更新于 Oct 29, 2026

Convert Korean HWP/HWPX (한글) documents to Markdown and extract tables. No keys needed.

已验证STDIO仅桌面文件与存储数据与分析

概览

AI 生成的概览

本地 MCP 服务器，将韩文 HWP/HWPX（한글）文档转换为 Markdown 并提取表格，便于助手阅读。

可以做什么
  • 把 HWP 或 HWPX 文档转换为 Markdown，包含段落、大纲标题和表格
  • 将文档中的全部表格提取为 JSON 行列数组，便于后续计算
  • 查看文件的格式、版本、标题、节/段落/表格/图片数量以及加密或分发版标记
  • 支持以本地路径、URL 或 base64 内容提供文档
适用场景
适合助手需要阅读韩文办公文档（如公文、合同、投标文件、备忘录）时使用，也适合把物品清单、报价、日程表等表格转成结构化数据。
运行要求
作为本地 stdio 进程运行，通常通过 npx 从 npm 包启动，需要 Node.js。未声明任何 API 密钥、账号或环境变量。文档需以路径、URL 或 base64 内容提供。
安装前请注意
所有工具均说明为只读，README 称文件在本机处理、不经过外部服务。受密码保护和分发版副本会返回错误，不支持 HWP 3.x。图片只计数、不提取。

安装

在 SourceWeft 中

  1. 打开 控制台中的 HWP to Markdown，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@appmonster/mcp-hwp

MCP server that turns HWP / HWPX (한글) documents into Markdown so AI agents can finally read Korean government notices, contracts, bid documents and office memos. Pure TypeScript, no 한글 installation, no external service — the file never leaves your machine.

한글 문서를 마크다운으로. 공문·계약서·입찰서류를 에이전트가 읽게 합니다.

Install

json
{  "mcpServers": {    "hwp": { "command": "npx", "args": ["-y", "@appmonster/mcp-hwp"] }  }}

No keys, no setup. Also works as a CLI: npx @appmonster/mcp-hwp 공문.hwp > 공문.md.

Tools (all read-only)

ToolWhat it does
hwp_to_markdownParagraphs, outline headings (개요 1~7 → #…), tables → Markdown. Input: path | url | base64
hwp_extract_tablesEvery table as JSON string[][] — for 물품내역, 견적, 일정표
hwp_infoFormat, version, title, counts, encryption / 배포용 flags — without the full text

What is supported

HWP 5.x (binary)HWPX (OWPML)
Body text, line breaks, tabs✓✓
Headings from 개요/제목 styles✓✓
Tables incl. row/col spans✓✓
Title / author metadatabest effort✓
Imagescounted, not extractedcounted, not extracted
Password-protectedclear error—
배포용 (distribution) copiesclear error—
HWP 3.x (1990s format)not supported — re-save as HWP 5/HWPX

Example prompts

  • "이 공문 요약해줘" (파일 첨부 또는 경로)
  • "입찰 서류의 물품 내역 표를 엑셀로 옮길 수 있게 JSON으로 뽑아줘"
  • "https://…/안내문.hwpx 읽고 마감일이 언제인지 알려줘"

MIT © Appmonster

来源：packages/hwp/README.md，提交 2f1998f

工具

3

hwp_to_markdown

Convert a Korean HWP or HWPX (한글) document to Markdown: paragraphs, outline headings, tables. Pass exactly one of path | url | base64. 한글 문서를 마크다운으로 변환합니다. Use whenever a user gives you a .hwp/.hwpx file or link (공문, 계약서, 입찰서류). Needs the file location.

输入参数urlpathbase64maxChars

hwp_extract_tables

Extract all tables from an HWP/HWPX document as JSON arrays (rows × columns of cell text). 한글 문서의 표를 JSON 배열로 추출합니다. Use for 물품내역, 견적, 일정표 — anything you will compute on. Needs the file location.

输入参数urlpathbase64

hwp_info

Quick facts about an HWP/HWPX file without the full text: format, version, title, section/paragraph/table/image counts, whether it is encrypted or a 배포용 copy. 변환 전에 문서 정보를 확인합니다. Needs the file location.

输入参数urlpathbase64

版本历史

2
  1. v0.1.1最新Oct 23, 2026
  2. v0.1.0Oct 21, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分