zardus_mem

Persistent MCP memory server for Zardus AI. Enables knowledge graph-based memory across conversations.

Quick Install

npm install -g zardus-mem

Setup

Option 1: Run setup script

chmod +x setup.sh
./setup.sh

Option 2: Manual install

npm install -g zardus-mem

Configuration

OpenCode / Claude Desktop

Add to your MCP config:

{
  "mcpServers": {
    "zardus_mem": {
      "command": "npx",
      "args": ["-y", "zardus-mem"],
      "env": {
        "MEMORY_FILE_PATH": "~/.zardus/memory/memory.jsonl"
      }
    }
  }
}

VS Code

Run MCP: Open User Configuration and add:

{
  "servers": {
    "zardus_mem": {
      "command": "npx",
      "args": ["-y", "zardus-mem"],
      "env": {
        "MEMORY_FILE_PATH": "~/.zardus/memory/memory.jsonl"
      }
    }
  }
}

Environment Variables

| Variable | Description | Default | |---|---|---| | MEMORY_FILE_PATH | Path to the JSONL storage file | memory.jsonl in package directory |

Memory Primitives

| Tool | Description | |---|---| | create_entities | Create new entities (person, org, event, etc.) | | create_relations | Create directed relations between entities | | add_observations | Add observations to existing entities | | delete_entities | Remove entities and cascading relations | | delete_observations | Remove specific observations | | delete_relations | Remove specific relations | | read_graph | Read entire knowledge graph | | search_nodes | Search nodes by query | | open_nodes | Retrieve specific nodes by name |

System Prompt

Use this prompt to enable memory utilization:

Follow these steps for each interaction:

1. User Identification:
   - Assume you are interacting with default_user
   - If not identified, proactively try to do so

2. Memory Retrieval:
   - Begin each chat by saying "Remembering..." and retrieve all relevant information from your knowledge graph
   - Refer to your knowledge graph as your "memory"

3. Memory:
   - During conversation, note new information:
     a) Basic Identity (age, gender, location, job, education)
     b) Behaviors (interests, habits)
     c) Preferences (communication style, language)
     d) Goals (targets, aspirations)
     e) Relationships (personal and professional)

4. Memory Update:
   - Create entities for recurring organizations, people, events
   - Connect them with relations
   - Store facts as observations

License

MIT