# Vanguard Memory Node MCP server

> Provides AI agents with a local, deterministic BM25-indexed memory vault for persistent, offline-first text storage and retrieval.

- Repository: https://github.com/ezumba/vanguard-memory-node
- Page: https://hostedmcp.org/servers/ezumba/vanguard-memory-node
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 2.0.1

## Install

### Claude Code

```sh
claude mcp add vanguard-memory-node -- npx -y @lnes/vanguard-memory-node
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "vanguard-memory-node": {
      "command": "npx",
      "args": [
        "-y",
        "@lnes/vanguard-memory-node"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "vanguard-memory-node": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@lnes/vanguard-memory-node"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"vanguard-memory-node","type":"stdio","command":"npx","args":["-y","@lnes/vanguard-memory-node"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "vanguard-memory-node": {
      "command": "npx",
      "args": [
        "-y",
        "@lnes/vanguard-memory-node"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add vanguard-memory-node -- npx -y @lnes/vanguard-memory-node
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.vanguard-memory-node]
command = "npx"
args = ["-y", "@lnes/vanguard-memory-node"]
```

### Gemini CLI

```sh
gemini mcp add -s user vanguard-memory-node npx -- -y @lnes/vanguard-memory-node
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "vanguard-memory-node": {
      "command": "npx",
      "args": [
        "-y",
        "@lnes/vanguard-memory-node"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `AUTO_SYNC_VAULT` | no | no |  |
| `EXERGYNET_API_KEY` | no | no |  |
| `EXERGYNET_NETWORK` | no | no |  |

## Tools (13)

- `text`
- `title`
- `namespace`
- `tags`
- `content_type`
- `source`
- `hash`
- `query`
- `limit`
- `file_path`
- `session_id`
- `xlmp_root`
- `intent`

## FAQ

### Does this require a cloud connection or API key?

No, it is an offline-first solution that stores data entirely on your local disk. An API key is only required if you choose to sync vaults to the ExergyNet ledger.

### How does the retrieval process work?

It uses a deterministic BM25 scoring system with a sharded inverted index, involving normalization, suffix stemming, and alias expansion.

### Can I ingest files continuously without creating duplicates?

Yes, the vmn_ingest_file tool tracks progress with a cursor, allowing it to only ingest new lines from growing files.
