@danielsimonjr/memory-mcp 12.8.2 → 12.9.0

package/README.md

@@ -178,14 +178,14 @@ git clone https://github.com/danielsimonjr/memory-mcp.git
 cd memory-mcp
 
 # Install and build
-npm install
-npm run build
+bun install
+bun run build
 
-# Run tests (791 tests, ~85% statement coverage)
-npm test
+# Run tests (794 tests, ~85% statement coverage)
+bun run test
 
 # Type check
-npm run typecheck
+bun run typecheck
 ```
 
 ### Claude Desktop Configuration
@@ -774,20 +774,20 @@ node dist/migrate-from-jsonl-to-sqlite.js --from memory.db --to memory.jsonl
 
 ### Prerequisites
 
-- Node.js 18+
-- npm 9+
-- TypeScript 5.6+
+- Bun 1.4+ (install + scripts; `bun.lock` is authoritative)
+- Node.js 22+ (shipped runtime — CI smokes `dist/` under Node)
+- TypeScript 7+
 
 ### Build Commands
 
 ```bash
-npm install           # Install dependencies
-npm run build         # Build TypeScript
-npm test              # Run tests (791 tests across 36 files; ~85% coverage)
-npm run typecheck     # Strict type checking
-npm run watch         # Development watch mode
-npm run clean         # Remove dist/ directory
-npm run docs:deps     # Generate dependency graph
+bun install           # Install dependencies
+bun run build         # Build TypeScript
+bun run test          # Run tests (794 tests across 37 files; ~85% coverage)
+bun run typecheck     # Strict type checking
+bun run watch         # Development watch mode
+bun run clean         # Remove dist/ directory
+bun run docs:deps     # Generate dependency graph
 ```
 
 ### Architecture

package/dist/index.js

@@ -22,7 +22,9 @@ let managerContext;
 // process alive as an orphan until manually killed.
 // ctx.close() (memoryjs v3) releases storage handles before exit; it is a
 // no-op for JSONL but closes the SQLite handle when MEMORY_STORAGE_TYPE=sqlite.
+let mcpServer;
 function shutdown() {
+    void mcpServer?.close();
     managerContext?.close();
     process.exit(0);
 }
@@ -40,8 +42,8 @@ async function main() {
         storageType,
     });
     // Initialize and start MCP server
-    const server = new MCPServer(managerContext);
-    await server.start();
+    mcpServer = new MCPServer(managerContext);
+    await mcpServer.start();
 }
 main().catch((error) => {
     logger.error("Fatal error in main():", error);

package/dist/server/MCPServer.d.ts

@@ -4,6 +4,9 @@
  * Handles Model Context Protocol server initialization and tool registration.
  * Tool definitions and handlers are extracted to separate modules for maintainability.
  *
+ * Serves MCP protocol revision 2026-07-28 via `serveStdio`, with backward-compatible
+ * support for 2025-era clients on the same stdio connection.
+ *
  * @module server/MCPServer
  */
 import { type ManagerContext } from '@danielsimonjr/memoryjs';
@@ -12,10 +15,16 @@ import { type ManagerContext } from '@danielsimonjr/memoryjs';
  * Exposes tools for entity/relation management, search, and analysis.
  */
 export declare class MCPServer {
-    private server;
     private ctx;
+    private stdioHandle;
     constructor(ctx: ManagerContext);
-    private registerToolHandlers;
+    /**
+     * Build a fresh Server instance for one stdio connection.
+     * `serveStdio` pins one instance per connection; the shared ManagerContext
+     * holds graph state across reconnects.
+     */
+    private createServer;
     start(): Promise<void>;
+    close(): Promise<void>;
 }
 //# sourceMappingURL=MCPServer.d.ts.map

package/dist/server/MCPServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MCPServer.d.ts","sourceRoot":"","sources":["../../src/server/MCPServer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAqBtE;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAAiB;IAE5B,YAAY,GAAG,EAAE,cAAc,EAe9B;IAED,OAAO,CAAC,oBAAoB;IAetB,KAAK,kBAIV;CACF"}
+{"version":3,"file":"MCPServer.d.ts","sourceRoot":"","sources":["../../src/server/MCPServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAqBtE;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,WAAW,CAAkC;IAErD,YAAY,GAAG,EAAE,cAAc,EAE9B;IAED;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAyBd,KAAK,kBAGV;IAEK,KAAK,kBAGV;CACF"}

package/dist/server/MCPServer.js

@@ -4,12 +4,14 @@
  * Handles Model Context Protocol server initialization and tool registration.
  * Tool definitions and handlers are extracted to separate modules for maintainability.
  *
+ * Serves MCP protocol revision 2026-07-28 via `serveStdio`, with backward-compatible
+ * support for 2025-era clients on the same stdio connection.
+ *
  * @module server/MCPServer
  */
 import { createRequire } from 'node:module';
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { Server } from '@modelcontextprotocol/server';
+import { serveStdio } from '@modelcontextprotocol/server/stdio';
 import { logger } from '@danielsimonjr/memoryjs';
 import { toolDefinitions } from './toolDefinitions.js';
 import { handleToolCall } from './toolHandlers.js';
@@ -27,36 +29,40 @@ const version = typeof __PKG_VERSION__ === 'string'
  * Exposes tools for entity/relation management, search, and analysis.
  */
 export class MCPServer {
-    server;
     ctx;
+    stdioHandle = null;
     constructor(ctx) {
         this.ctx = ctx;
-        this.server = new Server({
-            name: "memory-server",
+    }
+    /**
+     * Build a fresh Server instance for one stdio connection.
+     * `serveStdio` pins one instance per connection; the shared ManagerContext
+     * holds graph state across reconnects.
+     */
+    createServer() {
+        const server = new Server({
+            name: 'memory-server',
             version,
         }, {
             capabilities: {
                 tools: {},
             },
         });
-        this.registerToolHandlers();
-    }
-    registerToolHandlers() {
-        // Register list tools handler
-        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
-            return {
-                tools: toolDefinitions,
-            };
-        });
-        // Register call tool handler
-        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        server.setRequestHandler('tools/list', async () => ({
+            tools: toolDefinitions,
+        }));
+        server.setRequestHandler('tools/call', async (request) => {
             const { name, arguments: args } = request.params;
-            return handleToolCall(name, args || {}, this.ctx);
+            return handleToolCall(name, args ?? {}, this.ctx);
         });
+        return server;
     }
     async start() {
-        const transport = new StdioServerTransport();
-        await this.server.connect(transport);
-        logger.info('Knowledge Graph MCP Server running on stdio');
+        this.stdioHandle = serveStdio(() => this.createServer());
+        logger.info('Knowledge Graph MCP Server running on stdio (MCP 2026-07-28)');
+    }
+    async close() {
+        await this.stdioHandle?.close();
+        this.stdioHandle = null;
     }
 }

package/dist/server/toolHandlers.d.ts

@@ -8,6 +8,15 @@
  * @module server/toolHandlers
  */
 import { formatToolResponse, type ManagerContext } from '@danielsimonjr/memoryjs';
+/**
+ * Read the active project scope for a context.
+ *
+ * The scope is per-context session state set by the `set_project_scope` tool.
+ * It is held in a WeakMap because `ctx.defaultProjectId` is readonly.
+ *
+ * @param ctx - The manager context to read the scope from.
+ * @returns The active project id, or `undefined` when no scope is set.
+ */
 export declare function getActiveProjectScope(ctx: ManagerContext): string | undefined;
 /**
  * Tool response type for MCP SDK compatibility.

package/dist/server/toolHandlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolHandlers.d.ts","sourceRoot":"","sources":["../../src/server/toolHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,kBAAkB,EA2ClB,KAAK,cAAc,EAyBpB,MAAM,yBAAyB,CAAC;AAyBjC,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAE7E;AAgFD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,YAAY,CAAC,CAAC;AAiF3B,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAuuGpD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,YAAY,CAAC,CAiBvB"}
+{"version":3,"file":"toolHandlers.d.ts","sourceRoot":"","sources":["../../src/server/toolHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,kBAAkB,EA2ClB,KAAK,cAAc,EAyBpB,MAAM,yBAAyB,CAAC;AAyBjC;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAE7E;AAgFD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,YAAY,CAAC,CAAC;AAiF3B,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAkvGpD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,YAAY,CAAC,CAiBvB"}

package/dist/server/toolHandlers.js

@@ -29,6 +29,15 @@ const queryCostEstimatorMap = new WeakMap();
 // `set_project_scope` tool; handlers may consult `getActiveProjectScope(ctx)`
 // when they want to auto-apply the scope.
 const projectScopeMap = new WeakMap();
+/**
+ * Read the active project scope for a context.
+ *
+ * The scope is per-context session state set by the `set_project_scope` tool.
+ * It is held in a WeakMap because `ctx.defaultProjectId` is readonly.
+ *
+ * @param ctx - The manager context to read the scope from.
+ * @returns The active project id, or `undefined` when no scope is set.
+ */
 export function getActiveProjectScope(ctx) {
     return projectScopeMap.get(ctx);
 }
@@ -1244,6 +1253,17 @@ export const toolHandlers = {
             return formatTextResponse('No active consolidation scheduler found. Start one first with start_consolidation.');
         }
         scheduler.stop();
+        // `stop()` clears the interval but cannot cancel a cycle already running:
+        // `runConsolidationCycle` checks `running` only on entry, then awaits a full
+        // graph save. `start()` fires one cycle IMMEDIATELY -- it does not wait for
+        // the interval, which defaults to an hour -- so a start/stop pair always
+        // leaves a write in flight. Returning "stopped" there is a lie the caller
+        // acts on: teardown that deletes the storage directory races the write and
+        // logs `ConsolidationScheduler cycle error: ENOENT ... memory.jsonl.tmp.*`.
+        // memoryjs 4.2.0 exposes that cycle as `initialCyclePromise`; awaiting it
+        // makes "stopped" mean quiesced. The cycle handles its own errors, so this
+        // settles rather than rejects.
+        await scheduler.initialCyclePromise;
         return formatTextResponse('Consolidation scheduler stopped');
     },
     run_consolidation_now: async (ctx) => {

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@danielsimonjr/memory-mcp",
-  "version": "12.8.2",
+  "version": "12.9.0",
   "description": "Enhanced MCP memory server with hierarchies, compression, archiving, graph algorithms, semantic search, temporal KG, RBAC, bitemporal validity, OCC, procedural memory, causal reasoning, world model, do_not_remember exclusions, decision rationale, project context, heuristic guidelines, tool affordance + observer, observation dedup, spell correction, event memory, reconstructive memory, relation consolidation, agent reflection, and 241 advanced tools",
   "license": "MIT",
+  "packageManager": "bun@1.4.2",
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.0.0",
+    "bun": ">=1.4.2"
   },
   "author": "Daniel Simon Jr. (https://github.com/danielsimonjr)",
   "homepage": "https://github.com/danielsimonjr/memory-mcp",
@@ -48,7 +50,7 @@
   ],
   "scripts": {
     "build": "tsc",
-    "prepare": "npm run build",
+    "prepare": "tsc",
     "watch": "tsc --watch",
     "test": "vitest run --coverage",
     "typecheck": "tsc --noEmit --noUnusedLocals --noUnusedParameters --strict",
@@ -58,19 +60,20 @@
     "tools:build": "cd tools/chunking-for-files && npm run build && cd ../compress-for-context && npm run build && cd ../create-dependency-graph && npm run build && cd ../migrate-from-jsonl-to-sqlite && npm run build"
   },
   "dependencies": {
-    "@danielsimonjr/memoryjs": "^3.3.1",
-    "@modelcontextprotocol/sdk": "^1.30.0",
-    "zod": "^4.4.3"
+    "@danielsimonjr/memoryjs": "^4.2.0",
+    "@modelcontextprotocol/core": "^2.0.0",
+    "@modelcontextprotocol/server": "^2.0.0",
+    "zod": "^4.6.2"
   },
   "overrides": {
-    "better-sqlite3": "^12.11.1"
+    "better-sqlite3": "^13.0.3"
   },
   "devDependencies": {
     "@types/node": "^26",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/coverage-v8": "^5.0.0",
     "esbuild": "^0.28.2",
     "shx": "^0.4.0",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.5"
+    "vitest": "^5.0.0"
   }
 }