@j0hanz/memdb 1.0.1

package/README.md

@@ -0,0 +1,223 @@
+# memdb
+
+A memory-based MCP server using SQLite in-memory database.
+
+[![npm version](https://img.shields.io/npm/v/@j0hanz/memdb.svg)](https://www.npmjs.com/package/@j0hanz/memdb)
+
+## One-Click Install
+
+[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=memdb&inputs=%5B%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40j0hanz%2Fmemdb%40latest%22%5D%7D)[![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=memdb&inputs=%5B%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40j0hanz%2Fmemdb%40latest%22%5D%7D&quality=insiders)
+
+[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=memdb&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBqMGhhbnovbWVtZGJAbGF0ZXN0Il19)
+
+## ✨ Features
+
+| Feature                  | Description                                               |
+| :----------------------- | :-------------------------------------------------------- |
+| 🧠 **Memory Storage**    | Store text-based memories with tags and importance scores |
+| 🔍 **Full-Text Search**  | Search memories using FTS5 with relevance ranking         |
+| 🕸️ **Graph Connections** | Link memories together to create knowledge graphs         |
+| 📊 **Analytics**         | Track memory statistics and database health               |
+| 🔒 **Local Privacy**     | All data stored locally in SQLite (`data/memory.db`)      |
+
+## 🚀 Quick Start
+
+### VS Code / Cursor
+
+Add this to your `mcpServers` configuration:
+
+```json
+{
+  "memdb": {
+    "command": "npx",
+    "args": ["-y", "@j0hanz/memdb@latest"]
+  }
+}
+```
+
+## 📦 Installation
+
+### NPX (Recommended)
+
+```bash
+npx -y @j0hanz/memdb@latest
+```
+
+### Global Installation
+
+```bash
+npm install -g @j0hanz/memdb
+```
+
+### From Source
+
+```bash
+git clone https://github.com/j0hanz/memdb-mcp-server.git
+cd memdb-mcp-server
+npm install
+npm run build
+```
+
+## ⚙️ Configuration
+
+The server uses a local SQLite database located at `data/memory.db` relative to the working directory. No environment variables are required for basic operation.
+
+## 🔧 Tools
+
+### `store_memory`
+
+Store a new memory with optional tags and metadata.
+
+| Parameter    | Type     | Required | Default | Description                                     |
+| :----------- | :------- | :------- | :------ | :---------------------------------------------- |
+| `content`    | string   | ✅       | -       | The content of the memory                       |
+| `tags`       | string[] | ❌       | -       | Tags to categorize the memory                   |
+| `importance` | number   | ❌       | -       | Importance score (0-10)                         |
+| `memoryType` | string   | ❌       | -       | Type of memory (e.g., conversation, fact, rule) |
+
+**Returns:** The created memory object with its hash.
+
+### `search_memories`
+
+Full-text search with filters.
+
+| Parameter      | Type     | Required | Default | Description               |
+| :------------- | :------- | :------- | :------ | :------------------------ |
+| `query`        | string   | ✅       | -       | Search query              |
+| `limit`        | number   | ❌       | -       | Maximum number of results |
+| `tags`         | string[] | ❌       | -       | Filter by tags            |
+| `minRelevance` | number   | ❌       | -       | Minimum relevance score   |
+
+**Returns:** Array of matching memories.
+
+### `get_memory`
+
+Retrieve a specific memory by its hash.
+
+| Parameter | Type   | Required | Default | Description            |
+| :-------- | :----- | :------- | :------ | :--------------------- |
+| `hash`    | string | ✅       | -       | MD5 hash of the memory |
+
+**Returns:** The memory object.
+
+### `delete_memory`
+
+Delete a memory by its hash.
+
+| Parameter | Type   | Required | Default | Description            |
+| :-------- | :----- | :------- | :------ | :--------------------- |
+| `hash`    | string | ✅       | -       | MD5 hash of the memory |
+
+**Returns:** Confirmation of deletion.
+
+### `link_memories`
+
+Create a relationship between two memories.
+
+| Parameter      | Type   | Required | Default | Description               |
+| :------------- | :----- | :------- | :------ | :------------------------ |
+| `fromHash`     | string | ✅       | -       | Hash of the source memory |
+| `toHash`       | string | ✅       | -       | Hash of the target memory |
+| `relationType` | string | ✅       | -       | Type of relationship      |
+
+**Returns:** Confirmation of link creation.
+
+### `get_related`
+
+Get memories related to a given memory.
+
+| Parameter      | Type   | Required | Default | Description                 |
+| :------------- | :----- | :------- | :------ | :-------------------------- |
+| `hash`         | string | ✅       | -       | Hash of the memory          |
+| `relationType` | string | ❌       | -       | Filter by relationship type |
+| `depth`        | number | ❌       | -       | Traversal depth (1-3)       |
+
+**Returns:** Array of related memories.
+
+### `memory_stats`
+
+Get database statistics and health information.
+
+_No parameters required._
+
+**Returns:** Database statistics (count, size, etc.).
+
+## 🔌 Client Configuration
+
+<details>
+<summary><b>VS Code</b></summary>
+
+Add to your `settings.json` or `mcpServers` config:
+
+```json
+{
+  "mcpServers": {
+    "memdb": {
+      "command": "npx",
+      "args": ["-y", "@j0hanz/memdb@latest"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Claude Desktop</b></summary>
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "memdb": {
+      "command": "npx",
+      "args": ["-y", "@j0hanz/memdb@latest"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Cursor</b></summary>
+
+1. Go to **Cursor Settings** > **Features** > **MCP**
+2. Click **+ Add New MCP Server**
+3. Name: `memdb`
+4. Type: `command`
+5. Command: `npx -y @j0hanz/memdb@latest`
+
+</details>
+
+## 🛠️ Development
+
+### Prerequisites
+
+- Node.js >= 22.0.0
+
+### Scripts
+
+| Command         | Description                        |
+| :-------------- | :--------------------------------- |
+| `npm run build` | Compile TypeScript to `dist/`      |
+| `npm run dev`   | Run in development mode with watch |
+| `npm run test`  | Run tests                          |
+| `npm run lint`  | Run ESLint                         |
+
+### Project Structure
+
+```text
+src/
+├── index.ts          # Entry point
+├── core/             # Database and memory service
+├── tools/            # Tool implementations
+├── schemas/          # Zod input/output schemas
+├── lib/              # Utility functions
+└── utils/            # Config and logger
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/core/database.d.ts

@@ -0,0 +1,9 @@
+import { DatabaseSync } from 'node:sqlite';
+export declare class DatabaseManager {
+    private db;
+    constructor();
+    private init;
+    getDb(): DatabaseSync;
+}
+export declare const dbManager: DatabaseManager;
+//# sourceMappingURL=database.d.ts.map

package/dist/core/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/core/database.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAe;;IAYzB,OAAO,CAAC,IAAI;IA8EL,KAAK,IAAI,YAAY;CAG7B;AAED,eAAO,MAAM,SAAS,iBAAwB,CAAC"}

package/dist/core/database.js

@@ -0,0 +1,87 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import { config } from '../utils/config.js';
+export class DatabaseManager {
+    db;
+    constructor() {
+        const dbDir = path.dirname(config.dbPath);
+        if (!fs.existsSync(dbDir)) {
+            fs.mkdirSync(dbDir, { recursive: true });
+        }
+        this.db = new DatabaseSync(config.dbPath, { timeout: 5000 });
+        this.init();
+    }
+    init() {
+        this.db.exec('PRAGMA journal_mode = WAL');
+        this.db.exec('PRAGMA synchronous = NORMAL');
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS memories (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        content TEXT NOT NULL,
+        summary TEXT,
+        importance INTEGER DEFAULT 0,
+        memory_type TEXT DEFAULT 'general',
+        created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+        accessed_at TEXT DEFAULT CURRENT_TIMESTAMP,
+        hash TEXT UNIQUE NOT NULL
+      ) STRICT;
+    `);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS tags (
+        memory_id INTEGER NOT NULL,
+        tag TEXT NOT NULL,
+        PRIMARY KEY (memory_id, tag),
+        FOREIGN KEY (memory_id) REFERENCES memories(id) ON DELETE CASCADE
+      ) STRICT;
+    `);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS relationships (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        from_memory_id INTEGER NOT NULL,
+        to_memory_id INTEGER NOT NULL,
+        relation_type TEXT NOT NULL,
+        created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+        FOREIGN KEY (from_memory_id) REFERENCES memories(id) ON DELETE CASCADE,
+        FOREIGN KEY (to_memory_id) REFERENCES memories(id) ON DELETE CASCADE,
+        UNIQUE(from_memory_id, to_memory_id, relation_type)
+      ) STRICT;
+    `);
+        // FTS5
+        const ftsRow = this.db
+            .prepare("SELECT count(*) as count FROM sqlite_master WHERE type='table' AND name='memories_fts'")
+            .get();
+        const ftsExists = ftsRow?.count ?? 0;
+        if (ftsExists === 0) {
+            this.db.exec(`
+          CREATE VIRTUAL TABLE memories_fts USING fts5(
+            content,
+            summary,
+            content_rowid='id'
+          );
+        `);
+            this.db.exec(`
+          CREATE TRIGGER memories_ai AFTER INSERT ON memories BEGIN
+            INSERT INTO memories_fts(rowid, content, summary)
+            VALUES (new.id, new.content, new.summary);
+          END;
+        `);
+            this.db.exec(`
+          CREATE TRIGGER memories_au AFTER UPDATE ON memories BEGIN
+            DELETE FROM memories_fts WHERE rowid = old.id;
+            INSERT INTO memories_fts(rowid, content, summary) VALUES (new.id, new.content, new.summary);
+          END;
+        `);
+            this.db.exec(`
+          CREATE TRIGGER memories_ad AFTER DELETE ON memories BEGIN
+            DELETE FROM memories_fts WHERE rowid = old.id;
+          END;
+        `);
+        }
+    }
+    getDb() {
+        return this.db;
+    }
+}
+export const dbManager = new DatabaseManager();
+//# sourceMappingURL=database.js.map

package/dist/core/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/core/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,OAAO,eAAe;IAClB,EAAE,CAAe;IAEzB;QACE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEO,IAAI;QACV,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAE5C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;KAWZ,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;KAOZ,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;KAWZ,CAAC,CAAC;QAEH,OAAO;QACP,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE;aACnB,OAAO,CACN,wFAAwF,CACzF;aACA,GAAG,EAAmC,CAAC;QAC1C,MAAM,SAAS,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;QAErC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;SAMV,CAAC,CAAC;YAEL,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;SAKV,CAAC,CAAC;YAEL,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;SAKV,CAAC,CAAC;YAEL,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;SAIV,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/core/memory-service.d.ts

@@ -0,0 +1,31 @@
+import type { Memory, SearchResult } from '../types/index.js';
+interface RelatedMemory extends Memory {
+    relation_type: string;
+    depth: number;
+}
+interface StatementResult {
+    changes: number | bigint;
+    lastInsertRowid: number | bigint;
+}
+interface MemoryInsertResult {
+    id: number;
+    hash: string;
+    isNew: boolean;
+}
+interface MemoryStats {
+    memoryCount: number;
+    relationshipCount: number;
+}
+export declare class MemoryService {
+    private db;
+    createMemory(content: string, tags?: string[], importance?: number, memoryType?: string): MemoryInsertResult;
+    searchMemories(query: string, limit?: number, tags?: string[], minRelevance?: number): SearchResult[];
+    getMemory(hash: string): Memory | undefined;
+    deleteMemory(hash: string): StatementResult;
+    linkMemories(fromHash: string, toHash: string, relationType: string): StatementResult;
+    getRelated(hash: string, relationType?: string, depth?: number): RelatedMemory[];
+    getStats(): MemoryStats;
+}
+export declare const memoryService: MemoryService;
+export {};
+//# sourceMappingURL=memory-service.d.ts.map

package/dist/core/memory-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-service.d.ts","sourceRoot":"","sources":["../../src/core/memory-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAG9D,UAAU,aAAc,SAAQ,MAAM;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED,UAAU,kBAAkB;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,WAAW;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAqB;IAE/B,YAAY,CACV,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,UAAU,SAAI,EACd,UAAU,SAAY,GACrB,kBAAkB;IAwCrB,cAAc,CACZ,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,EACV,IAAI,GAAE,MAAM,EAAO,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,YAAY,EAAE;IA+DjB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAM3C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAM3C,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,eAAe;IAclB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,aAAa,EAAE;IA+E3E,QAAQ,IAAI,WAAW;CAaxB;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/core/memory-service.js

@@ -0,0 +1,179 @@
+import crypto from 'node:crypto';
+import { dbManager } from './database.js';
+export class MemoryService {
+    db = dbManager.getDb();
+    createMemory(content, tags = [], importance = 0, memoryType = 'general') {
+        const hash = crypto.createHash('md5').update(content).digest('hex');
+        // Check if exists
+        const existing = this.db
+            .prepare('SELECT id FROM memories WHERE hash = ?')
+            .get(hash);
+        if (existing) {
+            return { id: existing.id, hash, isNew: false };
+        }
+        const insert = this.db.prepare('INSERT INTO memories (content, importance, memory_type, hash) VALUES (?, ?, ?, ?)');
+        const uniqueTags = tags.length > 0 ? [...new Set(tags)] : [];
+        if (uniqueTags.length > 0) {
+            this.db.exec('BEGIN IMMEDIATE');
+            try {
+                const result = insert.run(content, importance, memoryType, hash);
+                const memoryId = result.lastInsertRowid;
+                const insertTag = this.db.prepare('INSERT INTO tags (memory_id, tag) VALUES (?, ?)');
+                for (const tag of uniqueTags) {
+                    insertTag.run(memoryId, tag);
+                }
+                this.db.exec('COMMIT');
+                return { id: memoryId, hash, isNew: true };
+            }
+            catch (err) {
+                this.db.exec('ROLLBACK');
+                throw err;
+            }
+        }
+        const result = insert.run(content, importance, memoryType, hash);
+        const memoryId = result.lastInsertRowid;
+        return { id: memoryId, hash, isNew: true };
+    }
+    searchMemories(query, limit = 10, tags = [], minRelevance) {
+        const uniqueTags = tags.length > 0 ? [...new Set(tags)] : [];
+        const relevanceExpr = '1.0 / (1.0 + abs(bm25(memories_fts)))';
+        const whereParts = ['memories_fts MATCH ?'];
+        const params = [query];
+        if (uniqueTags.length > 0) {
+            whereParts.push(`m.id IN (SELECT memory_id FROM tags WHERE tag IN (${uniqueTags
+                .map(() => '?')
+                .join(', ')}))`);
+            params.push(...uniqueTags);
+        }
+        let sql = `
+      WITH ranked AS (
+        SELECT m.*, ${relevanceExpr} as relevance
+        FROM memories m
+        JOIN memories_fts fts ON m.id = fts.rowid
+        WHERE ${whereParts.join(' AND ')}
+      )
+      SELECT * FROM ranked
+    `;
+        if (minRelevance !== undefined) {
+            sql += ' WHERE relevance >= ?';
+            params.push(minRelevance);
+        }
+        sql += ' ORDER BY relevance DESC LIMIT ?';
+        params.push(limit);
+        const stmt = this.db.prepare(sql);
+        let rows;
+        try {
+            rows = stmt.all(...params);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes('fts5') || message.includes('syntax error')) {
+                throw new Error(`Invalid search query syntax. Check for unbalanced quotes or special characters. Details: ${message}`);
+            }
+            throw err;
+        }
+        return rows.map((row) => ({
+            id: row.id,
+            content: row.content,
+            summary: row.summary,
+            importance: row.importance,
+            memory_type: row.memory_type,
+            created_at: row.created_at,
+            accessed_at: row.accessed_at,
+            hash: row.hash,
+            relevance: row.relevance,
+        }));
+    }
+    getMemory(hash) {
+        return this.db
+            .prepare('SELECT * FROM memories WHERE hash = ?')
+            .get(hash);
+    }
+    deleteMemory(hash) {
+        return this.db
+            .prepare('DELETE FROM memories WHERE hash = ?')
+            .run(hash);
+    }
+    linkMemories(fromHash, toHash, relationType) {
+        const from = this.getMemory(fromHash);
+        const to = this.getMemory(toHash);
+        if (!from || !to) {
+            throw new Error('One or both memories not found');
+        }
+        const insert = this.db.prepare('INSERT OR IGNORE INTO relationships (from_memory_id, to_memory_id, relation_type) VALUES (?, ?, ?)');
+        return insert.run(from.id, to.id, relationType);
+    }
+    getRelated(hash, relationType, depth = 1) {
+        const memory = this.getMemory(hash);
+        if (!memory)
+            return [];
+        const maxDepth = Math.max(1, depth);
+        const baseFilter = relationType ? ' AND r.relation_type = ?' : '';
+        const baseParams = [memory.id];
+        if (relationType) {
+            baseParams.push(relationType);
+        }
+        if (maxDepth === 1) {
+            const sql = `
+        SELECT m.*, r.relation_type as relation_type, 1 as depth
+        FROM memories m
+        JOIN relationships r ON m.id = r.to_memory_id
+        WHERE r.from_memory_id = ?${baseFilter}
+      `;
+            const rows = this.db.prepare(sql).all(...baseParams);
+            return rows.map((row) => ({
+                id: row.id,
+                content: row.content,
+                summary: row.summary,
+                importance: row.importance,
+                memory_type: row.memory_type,
+                created_at: row.created_at,
+                accessed_at: row.accessed_at,
+                hash: row.hash,
+                relation_type: row.relation_type,
+                depth: row.depth,
+            }));
+        }
+        const sql = `
+      WITH RECURSIVE rels(depth, from_id, to_id, relation_type) AS (
+        SELECT 1, r.from_memory_id, r.to_memory_id, r.relation_type
+        FROM relationships r
+        WHERE r.from_memory_id = ?${baseFilter}
+        UNION ALL
+        SELECT rels.depth + 1, r.from_memory_id, r.to_memory_id, r.relation_type
+        FROM relationships r
+        JOIN rels ON r.from_memory_id = rels.to_id
+        WHERE rels.depth < ?${relationType ? ' AND r.relation_type = ?' : ''}
+      )
+      SELECT m.*, rels.relation_type as relation_type, MIN(rels.depth) as depth
+      FROM rels
+      JOIN memories m ON m.id = rels.to_id
+      GROUP BY m.id, rels.relation_type
+      ORDER BY depth, m.id
+    `;
+        const recursiveParams = [...baseParams, maxDepth];
+        if (relationType) {
+            recursiveParams.push(relationType);
+        }
+        const rows = this.db.prepare(sql).all(...recursiveParams);
+        return rows.map((row) => ({
+            id: row.id,
+            content: row.content,
+            summary: row.summary,
+            importance: row.importance,
+            memory_type: row.memory_type,
+            created_at: row.created_at,
+            accessed_at: row.accessed_at,
+            hash: row.hash,
+            relation_type: row.relation_type,
+            depth: row.depth,
+        }));
+    }
+    getStats() {
+        const memoryCount = this.db.prepare('SELECT COUNT(*) as count FROM memories').get().count;
+        const relationshipCount = this.db.prepare('SELECT COUNT(*) as count FROM relationships').get().count;
+        return { memoryCount, relationshipCount };
+    }
+}
+export const memoryService = new MemoryService();
+//# sourceMappingURL=memory-service.js.map

package/dist/core/memory-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-service.js","sourceRoot":"","sources":["../../src/core/memory-service.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import process from 'node:process';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createErrorResponse } from './lib/errors.js';
+import { registerAllTools } from './tools/index.js';
+import { logger } from './utils/logger.js';
+const require = createRequire(import.meta.url);
+const packageJson = require('../package.json');
+const SERVER_VERSION = packageJson.version ?? '0.0.0';
+const server = new McpServer({ name: 'memdb', version: SERVER_VERSION }, {
+    instructions: 'A Memory MCP Server for AI Assistants using node:sqlite',
+    capabilities: { logging: {} },
+});
+// Ensure tool errors always include structuredContent (matches DefaultOutputSchema).
+server.createToolError = (message) => createErrorResponse('E_TOOL_ERROR', message);
+registerAllTools(server);
+let transport;
+let shutdownInProgress = false;
+async function shutdown(signal) {
+    if (shutdownInProgress)
+        return;
+    shutdownInProgress = true;
+    logger.info(`Received ${signal}, shutting down gracefully...`);
+    const forceExitTimer = setTimeout(() => {
+        logger.warn('Shutdown timeout exceeded, forcing exit');
+        process.exit(1);
+    }, 5000);
+    try {
+        if (transport) {
+            await transport.close();
+        }
+        clearTimeout(forceExitTimer);
+        process.exit(0);
+    }
+    catch (err) {
+        logger.error('Error during shutdown:', err);
+        clearTimeout(forceExitTimer);
+        process.exit(1);
+    }
+}
+async function main() {
+    try {
+        transport = new StdioServerTransport();
+        await server.connect(transport);
+        logger.info('Memory MCP Server running on stdio');
+    }
+    catch (error) {
+        logger.error('Failed to start server', error);
+        process.exit(1);
+    }
+}
+void main();
+// Graceful shutdown handlers
+process.on('SIGTERM', () => void shutdown('SIGTERM'));
+process.on('SIGINT', () => void shutdown('SIGINT'));
+// Uncaught error handlers
+process.on('uncaughtException', (err, origin) => {
+    logger.error(`Uncaught exception (${origin}):`, err);
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason) => {
+    logger.error('Unhandled rejection:', reason);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,19 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export interface ErrorResponse extends CallToolResult {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    structuredContent: {
+        ok: false;
+        error: {
+            code: string;
+            message: string;
+        };
+        result?: unknown;
+    };
+    isError: true;
+}
+export declare function getErrorMessage(error: unknown): string;
+export declare function createErrorResponse(code: string, message: string, result?: unknown): ErrorResponse;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,iBAAiB,EAAE;QACjB,EAAE,EAAE,KAAK,CAAC;QACV,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QACzC,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,OAAO,EAAE,IAAI,CAAC;CACf;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAItD;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,GACf,aAAa,CAWf"}