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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
|
# MCP Server Automatic Backups
> **⚠️ DEPRECATION NOTICE**
>
> This MCP server is **EXPERIMENTAL** and **NOT ACTIVELY MAINTAINED**.
>
> The author currently manages prompts through slash commands and meta-commands
> in the hexai agent system, making this MCP server redundant for its original
> purpose. This code is kept for potential future enhancements (possibly with
> different functionality beyond prompt management), but no guarantees are made
> about stability or continued support.
>
> **This documentation is preserved for reference only.**
## ✅ Fully Automatic - No Manual Tools Required!
The hexai-mcp-server automatically creates backups **on every write operation**. You don't need any CLI tools - everything happens automatically when you use the MCP protocol.
## How It Works
### Architecture
```
MCP Client (Claude Code/Cursor)
↓
MCP Protocol (prompts/create, update, delete)
↓
MCP Server Handler
↓
PromptStore.Create/Update/Delete()
↓
[AUTOMATIC BACKUP] ← Happens here automatically!
↓
Write to user.jsonl
```
### Automatic Backup Triggers
Every operation through the MCP server automatically creates a backup:
1. **`prompts/create`**
```
Client → MCP Server → Store.Create()
↓
[AUTO BACKUP]
↓
Save new prompt
```
2. **`prompts/update`**
```
Client → MCP Server → Store.Update()
↓
[AUTO BACKUP]
↓
Save changes
```
3. **`prompts/delete`**
```
Client → MCP Server → Store.Delete()
↓
[AUTO BACKUP]
↓
Remove prompt
```
## Backup Details
### Storage Location
```
~/.local/hexai/data/prompts/backups/
├── user.jsonl.20260210-190358
├── user.jsonl.20260210-192145
├── user.jsonl.20260210-193422
└── ... (up to 10 backups)
```
### Backup Format
- **Filename**: `user.jsonl.YYYYMMDD-HHMMSS`
- **Timestamp**: When backup was created
- **Content**: Complete copy of user.jsonl before change
### Retention Policy
- Keeps last **10 backups** automatically
- Oldest backups auto-deleted when limit exceeded
- No manual cleanup needed
## Usage (MCP Clients Only)
### From Claude Code CLI
```javascript
// Claude Code will automatically use these MCP methods:
// Create a prompt
{
"method": "prompts/create",
"params": {
"name": "my_prompt",
"title": "My Prompt",
"messages": [...]
}
}
// ✅ Backup created automatically before save!
// Update a prompt
{
"method": "prompts/update",
"params": {
"name": "my_prompt",
"title": "Updated Title"
}
}
// ✅ Backup created automatically before update!
// Delete a prompt
{
"method": "prompts/delete",
"params": {
"name": "old_prompt"
}
}
// ✅ Backup created automatically before delete!
```
### From Cursor
Same automatic backups happen when using Cursor's MCP integration!
## Manual Recovery (If Needed)
In rare cases where you need to manually restore:
### List Backups
```bash
ls -lht ~/.local/hexai/data/prompts/backups/
```
Output:
```
-rw-r--r-- 1 paul paul 1.2K Feb 10 19:34 user.jsonl.20260210-193422
-rw-r--r-- 1 paul paul 1.1K Feb 10 19:21 user.jsonl.20260210-192145
-rw-r--r-- 1 paul paul 1.0K Feb 10 19:03 user.jsonl.20260210-190358
```
### Restore from Backup
```bash
# Copy backup to restore
cp ~/.local/hexai/data/prompts/backups/user.jsonl.20260210-193422 \
~/.local/hexai/data/prompts/user.jsonl
# Restart MCP client to reload
```
## Test Results
The automatic backup system is fully tested:
```
✓ TestAutomaticBackupOnCreate - Backup created on prompts/create
✓ TestAutomaticBackupOnUpdate - Backup created on prompts/update
✓ TestAutomaticBackupOnDelete - Backup created on prompts/delete
```
All tests pass with 71.7% coverage on the promptstore layer.
## Configuration
No configuration needed! Just set up your MCP client:
**Claude Code** (`~/.config/claude/mcp.json`):
```json
{
"mcpServers": {
"hexai-prompts": {
"command": "/home/paul/go/bin/hexai-mcp-server",
"args": [],
"env": {}
}
}
}
```
**Cursor** (`~/.cursor/mcp.json`):
```json
{
"mcpServers": {
"hexai": {
"command": "/home/paul/go/bin/hexai-mcp-server",
"args": [],
"env": {}
}
}
}
```
Then all backups happen automatically!
## Summary
✅ **Automatic** - Backups created on every MCP operation
✅ **Transparent** - Happens inside the store layer
✅ **No tools needed** - Everything through MCP protocol
✅ **Retention** - Keeps last 10 backups automatically
✅ **Timestamped** - Easy to identify when backup was made
✅ **Zero config** - Works out of the box
✅ **Tested** - Comprehensive unit tests
**You just use the MCP server through your client (Claude Code/Cursor) and backups happen automatically!** 🚀
|
