Skip to main content
Glama
rgbcap

hwpx-mcp-server

by rgbcap

hwpx-mcp-server

MCP server for reading and editing .hwpx (Hangul Word Processor) files.

Features

Tool

Description

hwpx_read_text

Extract all text from a .hwpx file

hwpx_edit_text

Find and replace text

hwpx_set_style

Change font/size/bold/italic/underline

hwpx_create

Create a new .hwpx file

Related MCP server: HWP-MCP

Installation

npm install
npm run build

Usage with gemini-cli

Add to your ~/.gemini/settings.json:

{
  "mcpServers": {
    "hwpx": {
      "command": "node",
      "args": ["/absolute/path/to/hwpx-mcp-server/dist/index.js"]
    }
  }
}

Development

npm run dev   # watch mode
npm run build # compile TypeScript
npm start     # run server

HWPX Structure

HWPX is a ZIP-based XML format:

doc.hwpx (ZIP)
├── mimetype               # must be first, uncompressed
├── META-INF/container.xml
└── Contents/
    ├── content.hpf        # manifest
    └── section0.xml       # body text (hp:t tags)

Notes

  • HWPX only (not legacy binary .hwp)

  • Style editing uses regex-based XML patching — open in 한글 to verify layout

  • mimetype entry must remain uncompressed (ZIP store method)

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables comprehensive control of Hangul (HWP) documents through an MCP server, supporting operations from basic document management to advanced formatting, tables, images, and document structure manipulation.
    6
    -
  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    An MCP server that enables AI models to control Hancom Office Hanword (HWP) documents on Windows. It allows for the automated creation, editing, and management of Korean word processor files, including text formatting and table manipulation.
    -
  • A
    license
    A
    quality
    A
    maintenance
    An MCP server for reading, writing, and managing Korean Hangul Word Processor (HWP/HWPX) files. It allows users to extract content, fill templates, and create new documents directly through AI assistants.
    34
    206 npm
    89
    MIT