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 分