HWPX

About

This project is an enhanced MCP (Model Context Protocol) server designed to facilitate automated editing of Hangeul (HWPX) documents, particularly when integrated with AI tools like Claude. Forked from an original project, it delivers significantly improved stability and functionality, offering cross-platform support by leveraging the ZIP + XML structure of HWPX files. The server addresses critical bugs, such as table saving failures and text overlap, and introduces robust technical improvements like atomic file writing and depth-based XML parsing to ensure reliable and precise document manipulation, making it a powerful tool for programmatic HWPX content management.

Key Features

• Comprehensive HWPX document manipulation with 77 dedicated tools covering paragraphs, tables, images, headers/footers, and styles.
• Critical bug fixes for table saving, text overlap, file corruption, and multi-cell updates, ensuring document integrity.
• Advanced file handling techniques including atomic file writing and smart lineseg reset for stable and safe modifications.
• Support for complex document elements like nested tables and dynamic Mermaid diagram insertion as images.
• Cross-platform compatibility across Windows, macOS, and Linux for HWPX editing, with style preservation.
• 1 GitHub stars

Use Cases

• Automating HWPX document generation and editing through integration with AI assistants like Claude and Cursor.
• Developing custom workflows for document processing, transformation, and content management across various operating systems.
• Programmatic extraction, search, and modification of structured content within HWPX files, including table cells.