How do I use hwpx-mcp-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@hwpx-mcp-server Extract all text from 'meeting_minutes.hwpx' and summarize it." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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)