hwpforge-bindings-mcp 0.5.1

Anvil — HwpForge MCP server for AI-native HWPX document tools
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

# hwpforge-mcp

MCP (Model Context Protocol) server for HwpForge — enables AI agents to create and edit Korean HWPX documents.

## Installation

```bash
cargo install hwpforge-mcp
```

Or build from source:

```bash
cargo build --release -p hwpforge-bindings-mcp
# Binary: target/release/hwpforge-mcp
```

## Platform Setup

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "hwpforge": {
      "command": "hwpforge-mcp"
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "hwpforge": {
      "command": "hwpforge-mcp"
    }
  }
}
```

### VS Code Copilot

Add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "hwpforge": {
      "type": "stdio",
      "command": "hwpforge-mcp"
    }
  }
}
```

### Claude Code

Add to `.claude/settings.json`:

```json
{
  "mcpServers": {
    "hwpforge": {
      "command": "hwpforge-mcp"
    }
  }
}
```

## Tools

| Tool                 | Description                          |
| -------------------- | ------------------------------------ |
| `hwpforge_convert`   | Markdown → HWPX document generation  |
| `hwpforge_inspect`   | HWPX document structure analysis     |
| `hwpforge_to_json`   | HWPX → JSON export (full or section) |
| `hwpforge_patch`     | Replace a section with edited JSON   |
| `hwpforge_templates` | List available style presets         |

## Workflow Examples

### Create a document

```
hwpforge_convert(markdown: "report.md", output_path: "report.hwpx")
```

### Edit an existing document

```
# 1. Inspect structure
hwpforge_inspect(file_path: "report.hwpx")

# 2. Export section to JSON
hwpforge_to_json(file_path: "report.hwpx", section: 0, output_path: "section0.json")

# 3. Edit the JSON, then patch back
hwpforge_patch(base_path: "report.hwpx", section: 0, section_json_path: "section0.json", output_path: "report_edited.hwpx")
```

## Transport

stdio (JSON-RPC 2.0). All logging goes to stderr.

## License

MIT OR Apache-2.0