@shodh/memory-mcp 0.1.61 → 0.1.71
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -4
- package/dist/index.js +2151 -544
- package/package.json +3 -3
- package/scripts/postinstall.cjs +3 -1
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
<h1 align="center">Shodh-Memory MCP Server</h1>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
|
-
<strong>v0.1.
|
|
8
|
+
<strong>v0.1.70</strong> | Persistent cognitive memory for AI agents
|
|
9
9
|
</p>
|
|
10
10
|
|
|
11
11
|
<p align="center">
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
- **Knowledge Graph**: Entity extraction and relationship tracking
|
|
31
31
|
- **Memory Consolidation**: Automatic decay, replay, and strengthening
|
|
32
32
|
- **1-Click Install**: Auto-downloads native server binary for your platform
|
|
33
|
-
- **Offline-First**: All models
|
|
33
|
+
- **Offline-First**: All models auto-downloaded on first run (~38MB total), no internet required after
|
|
34
34
|
- **Fast**: Sub-millisecond graph lookup, 30-50ms semantic search
|
|
35
35
|
|
|
36
36
|
## Installation
|
|
@@ -57,6 +57,17 @@ Config file locations:
|
|
|
57
57
|
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
58
58
|
- Linux: `~/.config/Claude/claude_desktop_config.json`
|
|
59
59
|
|
|
60
|
+
**Codex CLI** (`.codex/config.toml`):
|
|
61
|
+
```toml
|
|
62
|
+
[mcp_servers.shodh-memory]
|
|
63
|
+
startup_timeout_sec = 60
|
|
64
|
+
command = "npx"
|
|
65
|
+
args = ["-y", "@shodh/memory-mcp"]
|
|
66
|
+
env = { SHODH_API_KEY = "your-api-key-here" }
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
> **Note**: First run downloads the server binary (~15MB) plus embedding model (~23MB). The `startup_timeout_sec = 60` ensures enough time for initial setup.
|
|
70
|
+
|
|
60
71
|
**For Cursor/other MCP clients**: Similar configuration with the npx command.
|
|
61
72
|
|
|
62
73
|
## Environment Variables
|
|
@@ -70,7 +81,7 @@ Config file locations:
|
|
|
70
81
|
| `SHODH_STREAM` | Enable/disable streaming ingestion | `true` |
|
|
71
82
|
| `SHODH_PROACTIVE` | Enable/disable proactive memory surfacing | `true` |
|
|
72
83
|
|
|
73
|
-
## MCP Tools
|
|
84
|
+
## MCP Tools (15 total)
|
|
74
85
|
|
|
75
86
|
| Tool | Description |
|
|
76
87
|
|------|-------------|
|
|
@@ -80,12 +91,15 @@ Config file locations:
|
|
|
80
91
|
| `context_summary` | Get categorized context for session bootstrap |
|
|
81
92
|
| `list_memories` | List all stored memories |
|
|
82
93
|
| `forget` | Delete a specific memory by ID |
|
|
94
|
+
| `forget_by_tags` | Delete memories matching any of the specified tags |
|
|
95
|
+
| `forget_by_date` | Delete memories within a date range |
|
|
83
96
|
| `memory_stats` | Get statistics about stored memories |
|
|
84
97
|
| `recall_by_tags` | Find memories by tag |
|
|
85
98
|
| `recall_by_date` | Find memories within a date range |
|
|
86
99
|
| `verify_index` | Check vector index health |
|
|
87
100
|
| `repair_index` | Repair orphaned memories |
|
|
88
101
|
| `consolidation_report` | View memory consolidation activity |
|
|
102
|
+
| `streaming_status` | Check WebSocket streaming connection status |
|
|
89
103
|
|
|
90
104
|
## REST API (for Developers)
|
|
91
105
|
|
|
@@ -166,7 +180,7 @@ Based on Cowan's working memory model:
|
|
|
166
180
|
## How It Works
|
|
167
181
|
|
|
168
182
|
1. **Install**: `npx -y @shodh/memory-mcp` downloads the package
|
|
169
|
-
2. **Auto-spawn**: On first run, downloads the native server binary (~15MB)
|
|
183
|
+
2. **Auto-spawn**: On first run, downloads the native server binary (~15MB) and embedding model (~23MB)
|
|
170
184
|
3. **Connect**: MCP client connects to the server via stdio
|
|
171
185
|
4. **Ready**: Start using `remember` and `recall` tools
|
|
172
186
|
|