README.md
MCP server for reading and editing .hwpx (Hangul Word Processor) files.
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 |
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
mimetypeentry must remain uncompressed (ZIP store method)
Tools (4)
hwpx_read_textExtract all text from a .hwpx filehwpx_edit_textFind and replace text within a .hwpx filehwpx_set_styleChange font, size, bold, italic, or underline styleshwpx_createCreate a new .hwpx fileConfiguration
claude_desktop_config.json
{"mcpServers": {"hwpx": {"command": "node", "args": ["/absolute/path/to/hwpx-mcp-server/dist/index.js"]}}}Try it
→Extract all the text from the document located at /documents/report.hwpx.
→Find all occurrences of 'Draft' in /documents/proposal.hwpx and replace them with 'Final'.
→Change the font style to bold for the document at /documents/memo.hwpx.
→Create a new HWPX file named 'summary.hwpx' with the content 'Meeting Minutes'.