open-index/open-npm huggingface dataset:
npm package: @hwpxio/mcp-server
Description: MCP server for reading and converting Korean HWP/HWPX documents
Latest version: 0.2.0

# @hwpxio/mcp-server

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

## Quick Start

```bash
npx @hwpxio/mcp-server
```

Set `HWPXIO_API_KEY` environment variable. Get your key at [hwpx.io](https://hwpx.io/developer).

## Setup

### Claude Desktop

Add to `claude_desktop_config.json`:

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

### Cursor

Add to `.cursor/mcp.json`:

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

### Claude Code

```bash
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](https://hwpx.io/en/docs/mcp)

## License

MIT