MCPgee
MCPgee
MCPgeeMCPgee

hwpx-mcp-server

v1.0.0•File Systems•stable

An MCP server for reading, editing, and creating Hangul Word Processor (.hwpx) files. It enables users to extract text, perform find-and-replace operations, and modify font styles through automated XML patching.

ai-agentclaude-desktopdocument-automationhancomhwpx
Share:
57
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is hwpx-mcp-server?

hwpx-mcp-server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for reading, editing, and creating hangul word processor (.hwpx) files. it enables users to extract text, perform find-and-replace operations, and modify font styles through automated xml p...

An MCP server for reading, editing, and creating Hangul Word Processor (.hwpx) files. It enables users to extract text, perform find-and-replace operations, and modify font styles through automated XML patching.

This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP server for reading, editing, and creating Hangul Word

Use Cases

Read and edit Hangul Word Processor files via AI.
Extract text and perform find-and-replace operations.
Modify font styles through XML patching.
rgbcap

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMay 13, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx hwpx

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use hwpx-mcp-server

hwpx-mcp-server is a local MCP server that lets AI assistants read, edit, and create Hangul Word Processor (.hwpx) files — the dominant document format used in South Korean government and enterprise environments. It works by patching the underlying XML structure of .hwpx archives and exposes four tools: text extraction, find-and-replace, font/style modification, and new document creation. No external APIs or credentials are required, making it ideal for automating Korean document workflows entirely on-device.

Prerequisites

  • Node.js 18 or later and npm installed
  • Git to clone the repository (no npm package published yet)
  • An MCP-compatible client such as Claude Desktop, Cursor, or Gemini CLI
  • Basic familiarity with .hwpx files (Hangul Word Processor format)
1

Clone the repository

The server is distributed as source code. Clone it to a local directory where it will remain — the MCP client will reference this path.

git clone https://github.com/rgbcap/hwpx-mcp-server.git
cd hwpx-mcp-server
2

Install dependencies and build

Install npm dependencies and compile the TypeScript source to JavaScript in the dist/ directory.

npm install
npm run build
3

Note the absolute path to the built entry point

The MCP client config requires the absolute path to dist/index.js. Run 'pwd' inside the project directory to get the base path, then append /dist/index.js.

pwd
# Example output: /Users/you/tools/hwpx-mcp-server
# Entry point: /Users/you/tools/hwpx-mcp-server/dist/index.js
4

Add the server to your MCP client configuration

Open your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS) and add the hwpx server entry. Replace the path with your actual absolute path.

{
  "mcpServers": {
    "hwpx": {
      "command": "node",
      "args": ["/Users/you/tools/hwpx-mcp-server/dist/index.js"]
    }
  }
}
5

Restart Claude Desktop and verify

Quit and reopen Claude Desktop. The tools hwpx_read_text, hwpx_edit_text, hwpx_set_style, and hwpx_create should be available. Test by asking Claude to extract text from an .hwpx file.

hwpx-mcp-server Examples

Client configuration

claude_desktop_config.json entry for the hwpx MCP server using the locally built dist/index.js.

{
  "mcpServers": {
    "hwpx": {
      "command": "node",
      "args": ["/Users/you/tools/hwpx-mcp-server/dist/index.js"]
    }
  }
}

Prompts to try

Example prompts that exercise the four hwpx tools once the server is connected.

- "Read and extract all text from /Users/me/documents/report.hwpx."
- "In /Users/me/documents/contract.hwpx, replace all occurrences of '2023' with '2024'."
- "Change the font size to 14 and make all headings bold in /Users/me/presentation.hwpx."
- "Create a new .hwpx file at /Users/me/documents/draft.hwpx with the title 'Meeting Minutes'."

Troubleshooting hwpx-mcp-server

Claude reports 'Cannot find module dist/index.js'

Run 'npm run build' inside the hwpx-mcp-server directory to compile TypeScript. Ensure the path in the config is the full absolute path, not a relative one.

hwpx_edit_text makes no changes to the file

Verify that the .hwpx file is not open in Hangul Word Processor at the same time — the file may be locked. Also confirm the search string matches exactly, including spaces and Korean characters.

Server crashes when opening large .hwpx files

Large files with embedded media can exceed Node.js default memory. Start Node with increased heap: change the command in your config to 'node' and add '--max-old-space-size=512' as the first arg before the path.

Frequently Asked Questions about hwpx-mcp-server

What is hwpx-mcp-server?

hwpx-mcp-server is a Model Context Protocol (MCP) server that mcp server for reading, editing, and creating hangul word processor (.hwpx) files. it enables users to extract text, perform find-and-replace operations, and modify font styles through automated xml patching. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install hwpx-mcp-server?

Follow the installation instructions on the hwpx-mcp-server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with hwpx-mcp-server?

hwpx-mcp-server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is hwpx-mcp-server free to use?

Yes, hwpx-mcp-server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

hwpx-mcp-server Alternatives — Similar File Systems Servers

Looking for alternatives to hwpx-mcp-server? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.

Electerm

★ 14.1k

📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)

Plik

★ 1.8k

Plik is a temporary file upload system (Wetransfer like) in Go.

Kordoc

★ 957

An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.

macOS Automator

★ 801

A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.

PDF Reader

★ 723

Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.

Filesystem MCP Server

★ 643

Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.

Browse More File Systems MCP Servers

Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

File SystemsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "hwpx": { "command": "npx", "args": ["-y", "hwpx"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use hwpx-mcp-server?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides