@hwpforge/mcp

Vise — HwpForge MCP Server for AI-native Korean HWP/HWPX document tools

Install

npx -y @hwpforge/mcp

What is HwpForge?

HwpForge is a Rust library for programmatic control of Korean HWP/HWPX document formats. This package provides the MCP (Model Context Protocol) server that enables AI agents to generate, inspect, and edit Korean documents.

MCP Tools

| Tool | Description | | ---------------------- | ------------------------------------------------------ | | hwpforge_convert | Markdown to HWPX conversion | | hwpforge_inspect | Inspect HWPX document structure | | hwpforge_to_json | Export HWPX to JSON for editing | | hwpforge_from_json | Build an HWPX document directly from JSON | | hwpforge_patch | Replace a section's paragraph text with edited JSON | | hwpforge_outline | Navigation map: headings, tables, fields, bookmarks | | hwpforge_diff | Compare two HWPX files (semantic + package channels) | | hwpforge_delete_para | Delete top-level paragraphs by index | | hwpforge_insert_para | Insert a paragraph relative to an anchor | | hwpforge_read | Read a targeted paragraph range, table, or field | | hwpforge_fields | List named click-here fields (누름틀) | | hwpforge_fill | Fill named click-here fields by name → value | | hwpforge_stamp_plan | Discover prose placeholder candidates for stamping | | hwpforge_stamp | Promote placeholders to named click-here fields | | hwpforge_set_cell | Edit table cells by logical grid address | | hwpforge_validate | Validate HWPX structure and integrity | | hwpforge_restyle | Apply a different style preset to an existing document | | hwpforge_templates | List available style templates | | hwpforge_to_md | Convert HWPX to Markdown |

Configuration

Claude Code

claude mcp add hwpforge -- npx -y @hwpforge/mcp

Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "hwpforge": {
      "command": "npx",
      "args": ["-y", "@hwpforge/mcp"]
    }
  }
}

Supported Platforms

| Platform | Package | | ------------------- | ---------------------------- | | macOS Apple Silicon | @hwpforge/mcp-darwin-arm64 | | macOS Intel | @hwpforge/mcp-darwin-x64 | | Linux x64 | @hwpforge/mcp-linux-x64 | | Linux ARM64 | @hwpforge/mcp-linux-arm64 | | Windows x64 | @hwpforge/mcp-win32-x64 |

Alternative Installation

If npm is not available, install via Cargo:

cargo install hwpforge-bindings-mcp

Links

• GitHub
• Documentation
• crates.io

License

MIT OR Apache-2.0