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.

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