HWP to Markdown について
HWP to Markdown は、韓国語の HWP・HWPX 文書を Markdown に変換し、表を抽出する MCP サーバーです。한글 のインストールや外部サービスへのファイル送信なしで、韓国語の業務文書を扱うエージェントやワークフローに利用できます。
主な機能
- 01段落・見出し・表の Markdown 変換
- 02表を JSON 配列として抽出
- 03文書形式とメタデータの確認
- 04ローカルファイル・URL・base64 の入力
- 05外部サービスを使わない読み取り専用処理
活用シーン
- 01韓国政府の通知を AI エージェントで読み取る
- 02入札や見積もりの表を再利用向けに抽出
- 03文書のタイトル・バージョン・暗号化状態を確認
MCP 対応
読み取り専用の文書変換、表の抽出、メタデータ確認ツールを MCP クライアントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
3掲載時のツール一覧 · 6 日前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| url | string | いいえ | .hwp/.hwpx ファイルの http(s) URL |
| path | string | いいえ | ローカルファイルパス（例：~/Downloads/공문.hwp） |
| base64 | string | いいえ | Base64 形式のファイル内容（パスを共有できないクライアント向け） |
| maxChars | integer | いいえ | この文字数を超える出力を切り捨てます |
詳細
@appmonster/mcp-hwp
HWP / HWPX (한글) 문서를 Markdownに変換する MCP サーバーです。AI エージェントが韓国の政府通知、契約書、入札書類、社内メモを読めるようにします。純粋な TypeScript 製で、한글 のインストールも外部サービスも不要です。ファイルがマシンの外に送信されることはありません。
한글 문서를 마크다운으로. 공문·계약서·입찰서류를 에이전트가 읽게 합니다.
インストール
{
"mcpServers": {
"hwp": { "command": "npx", "args": ["-y", "@appmonster/mcp-hwp"] }
}
}
API キーもセットアップも不要です。CLI としても使用できます：npx @appmonster/mcp-hwp 공문.hwp > 공문.md。
ツール（すべて読み取り専用）
| ツール | 機能 |
|---|---|
hwp_to_markdown | 段落、アウトライン見出し（개요 1~7 → #…）、表を Markdown に変換します。入力：path | url | base64 |
hwp_extract_tables | すべての表を JSON string[][] として抽出します — 물품내역、견적、일정표向け |
hwp_info | 形式、バージョン、タイトル、件数、暗号化／배포용フラグを取得します — 全文を取得せずに確認できます |
対応状況
| HWP 5.x（バイナリ） | HWPX（OWPML） | |
|---|---|---|
| 本文、改行、タブ | ✓ | ✓ |
| 개요／제목スタイルからの見出し | ✓ | ✓ |
| 行／列の結合を含む表 | ✓ | ✓ |
| タイトル／作成者のメタデータ | 可能な範囲で対応 | ✓ |
| 画像 | 数をカウント、抽出はしません | 数をカウント、抽出はしません |
| パスワード保護 | 明確なエラーを表示 | — |
| 배포용（配布用）コピー | 明確なエラーを表示 | — |
| HWP 3.x（1990年代の形式） | 非対応 — HWP 5／HWPX として再保存してください |
プロンプトの例
- 「이 공문 요약해줘」（ファイルを添付するか、パスを指定）
- 「입찰 서류의 물품 내역 표를 엑셀로 옮길 수 있게 JSON으로 뽑아줘」
- 「https://…/안내문.hwpx を読んで、締め切りがいつか教えて」
MIT © Appmonster
コメント
Markdown 対応
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。