@hwpxio/mcp-server

MCP server that lets AI assistants read and convert Korean HWP/HWPX documents.

Quick Start

npx @hwpxio/mcp-server

Set HWPXIO_API_KEY environment variable. Get your key at hwpx.io.

Setup

Claude Desktop

Add to claude_desktop_config.json:

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

Cursor

Add to .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

Tools

| Tool | Description | |------|-------------| | read_hwpx | Read a .hwpx file and return Markdown text | | read_hwp | Read a .hwp file and return Markdown text | | convert | Convert a file to Markdown or HTML and save to disk | | read_directory | Read all HWP/HWPX files in a directory |

Remote MCP

Connect without local installation:

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

Requires X-API-Key header.

Documentation

Full documentation: hwpx.io/docs/mcp

License

MIT