MCP Server

Let AI agents read Korean documents

What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI assistants use external tools. The hwpx.io MCP server gives AI the ability to read and convert HWP/HWPX documents.

Installation

Install globally:

npm install -g @hwpxio/mcp-server

Or run directly with npx (no install needed).

Setup

Add the server to your AI tool's MCP configuration.

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "hwpxio": {
      "command": "npx",
      "args": ["-y", "@hwpxio/mcp-server"],
      "env": {
        "HWPXIO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "hwpxio": {
      "command": "npx",
      "args": ["-y", "@hwpxio/mcp-server"],
      "env": {
        "HWPXIO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add hwpxio -- npx -y @hwpxio/mcp-server

Available Tools

read_hwpx

Read a .hwpx file and return its text as Markdown.

read_hwp

Read a .hwp file and return its text as Markdown.

convert

Convert a .hwp/.hwpx file to Markdown or HTML and save to disk.

read_directory

Read all HWP/HWPX files in a directory at once.

convert_hwp_to_hwpx

Convert a .hwp file to .hwpx (the format required for Korean government submission) and save to disk.

convert_hwp_to_hwpx_bulk

Bulk-convert a directory or multiple .hwp files to .hwpx.

Remote MCP

Connect without local installation using the hosted endpoint. Available when your AI client supports remote MCP URLs.

https://hwpx.io/api/v1/mcp

Example Scenarios

Summarize a press release

"Read the hwpx file in my Downloads folder and summarize the key points."

Batch convert a folder

"Convert all HWP files in the documents/ directory to Markdown."

Bulk HWP → HWPX

"Convert every HWP file in documents/ to HWPX for government submission."