@shodh/memory-mcp 0.1.70 → 0.1.72

package/README.md

@@ -5,7 +5,7 @@
 <h1 align="center">Shodh-Memory MCP Server</h1>
 
 <p align="center">
-  <strong>v0.1.61</strong> | Persistent cognitive memory for AI agents
+  <strong>v0.1.70</strong> | Persistent cognitive memory for AI agents
 </p>
 
 <p align="center">
@@ -30,7 +30,7 @@
 - **Knowledge Graph**: Entity extraction and relationship tracking
 - **Memory Consolidation**: Automatic decay, replay, and strengthening
 - **1-Click Install**: Auto-downloads native server binary for your platform
-- **Offline-First**: All models bundled (~15MB), no internet required after install
+- **Offline-First**: All models auto-downloaded on first run (~38MB total), no internet required after
 - **Fast**: Sub-millisecond graph lookup, 30-50ms semantic search
 
 ## Installation
@@ -57,6 +57,17 @@ Config file locations:
 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 - Linux: `~/.config/Claude/claude_desktop_config.json`
 
+**Codex CLI** (`.codex/config.toml`):
+```toml
+[mcp_servers.shodh-memory]
+startup_timeout_sec = 60
+command = "npx"
+args = ["-y", "@shodh/memory-mcp"]
+env = { SHODH_API_KEY = "your-api-key-here" }
+```
+
+> **Note**: First run downloads the server binary (~15MB) plus embedding model (~23MB). The `startup_timeout_sec = 60` ensures enough time for initial setup.
+
 **For Cursor/other MCP clients**: Similar configuration with the npx command.
 
 ## Environment Variables
@@ -169,7 +180,7 @@ Based on Cowan's working memory model:
 ## How It Works
 
 1. **Install**: `npx -y @shodh/memory-mcp` downloads the package
-2. **Auto-spawn**: On first run, downloads the native server binary (~15MB)
+2. **Auto-spawn**: On first run, downloads the native server binary (~15MB) and embedding model (~23MB)
 3. **Connect**: MCP client connects to the server via stdio
 4. **Ready**: Start using `remember` and `recall` tools
 

package/dist/index.js

@@ -5125,7 +5125,11 @@ async function apiCall(endpoint, method = "GET", body) {
       }
     }
   }
-  throw new Error(`Failed after ${RETRY_ATTEMPTS} attempts: ${lastError?.message || "Unknown error"}`);
+  const errMsg = lastError?.message || "Unknown error";
+  if (errMsg.includes("ECONNREFUSED") || errMsg.includes("fetch failed")) {
+    throw new Error(`Cannot connect to shodh-memory server at ${API_URL}. ` + `Start the server with: shodh-memory-server`);
+  }
+  throw new Error(`Failed after ${RETRY_ATTEMPTS} attempts: ${errMsg}`);
 }
 async function isServerAvailable() {
   try {
@@ -7842,7 +7846,12 @@ async function ensureServerRunning() {
     return;
   }
   if (!AUTO_SPAWN_ENABLED) {
-    console.error("[shodh-memory] Auto-spawn disabled. Please start the server manually.");
+    console.error("[shodh-memory] Server not running at", API_URL);
+    console.error("[shodh-memory] Auto-spawn disabled (SHODH_AUTO_SPAWN=false).");
+    console.error("[shodh-memory] Start the server manually:");
+    console.error("[shodh-memory]   shodh-memory-server");
+    console.error("[shodh-memory] Or with Docker:");
+    console.error("[shodh-memory]   docker run -d -p 3030:3030 roshera/shodh-memory");
     return;
   }
   const binaryPath = getBinaryPath();

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@shodh/memory-mcp",
-  "version": "0.1.70",
+  "version": "0.1.72",
   "mcpName": "io.github.varun29ankuS/shodh-memory",
   "description": "MCP server for persistent AI memory - store and recall context across sessions",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "shodh-memory-mcp": "./dist/index.js"
+    "shodh-memory-mcp": "dist/index.js"
   },
   "scripts": {
     "start": "bun run index.ts",
@@ -36,7 +36,7 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/varun29ankuS/shodh-memory"
+    "url": "git+https://github.com/varun29ankuS/shodh-memory.git"
   },
   "homepage": "https://github.com/varun29ankuS/shodh-memory#readme",
   "bugs": {

package/scripts/postinstall.cjs

@@ -1,134 +1,134 @@
-#!/usr/bin/env node
-/**
- * Postinstall script for @shodh/memory-mcp
- *
- * Downloads the appropriate shodh-memory-server binary for the current platform
- * from GitHub releases.
- */
-
-const fs = require('fs');
-const path = require('path');
-const https = require('https');
-const { execSync } = require('child_process');
-
-const VERSION = '0.1.6';
-const REPO = 'varun29ankuS/shodh-memory';
-const BIN_DIR = path.join(__dirname, '..', 'bin');
-
-// Platform detection
-function getPlatformInfo() {
-  const platform = process.platform;
-  const arch = process.arch;
-
-  if (platform === 'linux' && arch === 'x64') {
-    return { name: 'shodh-memory-linux-x64', ext: '.tar.gz', binary: 'shodh-memory-server' };
-  } else if (platform === 'linux' && arch === 'arm64') {
-    return { name: 'shodh-memory-linux-arm64', ext: '.tar.gz', binary: 'shodh-memory-server' };
-  } else if (platform === 'darwin' && arch === 'x64') {
-    return { name: 'shodh-memory-macos-x64', ext: '.tar.gz', binary: 'shodh-memory-server' };
-  } else if (platform === 'darwin' && arch === 'arm64') {
-    return { name: 'shodh-memory-macos-arm64', ext: '.tar.gz', binary: 'shodh-memory-server' };
-  } else if (platform === 'win32' && arch === 'x64') {
-    return { name: 'shodh-memory-windows-x64', ext: '.zip', binary: 'shodh-memory-server.exe' };
-  } else {
-    return null;
-  }
-}
-
-// Download file with redirect following
-function download(url, dest) {
-  return new Promise((resolve, reject) => {
-    const file = fs.createWriteStream(dest);
-
-    const request = (url) => {
-      https.get(url, (response) => {
-        if (response.statusCode === 302 || response.statusCode === 301) {
-          // Follow redirect
-          request(response.headers.location);
-          return;
-        }
-
-        if (response.statusCode !== 200) {
-          reject(new Error(`Failed to download: ${response.statusCode}`));
-          return;
-        }
-
-        response.pipe(file);
-        file.on('finish', () => {
-          file.close();
-          resolve();
-        });
-      }).on('error', (err) => {
-        fs.unlink(dest, () => {});
-        reject(err);
-      });
-    };
-
-    request(url);
-  });
-}
-
-// Extract archive
-function extract(archive, dest, platformInfo) {
-  if (platformInfo.ext === '.tar.gz') {
-    execSync(`tar -xzf "${archive}" -C "${dest}"`, { stdio: 'inherit' });
-  } else if (platformInfo.ext === '.zip') {
-    // Use PowerShell on Windows
-    execSync(`powershell -Command "Expand-Archive -Path '${archive}' -DestinationPath '${dest}' -Force"`, { stdio: 'inherit' });
-  }
-}
-
-async function main() {
-  const platformInfo = getPlatformInfo();
-
-  if (!platformInfo) {
-    console.log('[shodh-memory] Unsupported platform:', process.platform, process.arch);
-    console.log('[shodh-memory] You will need to run the server manually.');
-    return;
-  }
-
-  console.log('[shodh-memory] Installing server binary for', process.platform, process.arch);
-
-  // Create bin directory
-  if (!fs.existsSync(BIN_DIR)) {
-    fs.mkdirSync(BIN_DIR, { recursive: true });
-  }
-
-  const binaryPath = path.join(BIN_DIR, platformInfo.binary);
-
-  // Check if already installed
-  if (fs.existsSync(binaryPath)) {
-    console.log('[shodh-memory] Binary already installed at', binaryPath);
-    return;
-  }
-
-  // Download URL
-  const downloadUrl = `https://github.com/${REPO}/releases/download/v${VERSION}/${platformInfo.name}${platformInfo.ext}`;
-  const archivePath = path.join(BIN_DIR, `${platformInfo.name}${platformInfo.ext}`);
-
-  console.log('[shodh-memory] Downloading from', downloadUrl);
-
-  try {
-    await download(downloadUrl, archivePath);
-    console.log('[shodh-memory] Downloaded archive');
-
-    // Extract
-    extract(archivePath, BIN_DIR, platformInfo);
-    console.log('[shodh-memory] Extracted binary');
-
-    // Clean up archive
-    fs.unlinkSync(archivePath);
-
-    // Make executable (Unix)
-    if (process.platform !== 'win32') {
-      fs.chmodSync(binaryPath, 0o755);
-    }
-
-    console.log('[shodh-memory] Server binary installed at', binaryPath);
-  } catch (err) {
-    console.error('[shodh-memory] Failed to install binary:', err.message);
-    console.log('[shodh-memory] You can manually download from:', `https://github.com/${REPO}/releases`);
-  }
-}
-
-main();
+#!/usr/bin/env node
+/**
+ * Postinstall script for @shodh/memory-mcp
+ *
+ * Downloads the appropriate shodh-memory-server binary for the current platform
+ * from GitHub releases.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const { execSync } = require('child_process');
+
+const VERSION = '0.1.72';
+const REPO = 'varun29ankuS/shodh-memory';
+const BIN_DIR = path.join(__dirname, '..', 'bin');
+
+// Platform detection
+function getPlatformInfo() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  if (platform === 'linux' && arch === 'x64') {
+    return { name: 'shodh-memory-linux-x64', ext: '.tar.gz', binary: 'shodh-memory-server' };
+  } else if (platform === 'linux' && arch === 'arm64') {
+    return { name: 'shodh-memory-linux-arm64', ext: '.tar.gz', binary: 'shodh-memory-server' };
+  } else if (platform === 'darwin' && arch === 'x64') {
+    return { name: 'shodh-memory-macos-x64', ext: '.tar.gz', binary: 'shodh-memory-server' };
+  } else if (platform === 'darwin' && arch === 'arm64') {
+    return { name: 'shodh-memory-macos-arm64', ext: '.tar.gz', binary: 'shodh-memory-server' };
+  } else if (platform === 'win32' && arch === 'x64') {
+    return { name: 'shodh-memory-windows-x64', ext: '.zip', binary: 'shodh-memory-server.exe' };
+  } else {
+    return null;
+  }
+}
+
+// Download file with redirect following
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+
+    const request = (url) => {
+      https.get(url, (response) => {
+        if (response.statusCode === 302 || response.statusCode === 301) {
+          // Follow redirect
+          request(response.headers.location);
+          return;
+        }
+
+        if (response.statusCode !== 200) {
+          reject(new Error(`Failed to download: ${response.statusCode}`));
+          return;
+        }
+
+        response.pipe(file);
+        file.on('finish', () => {
+          file.close();
+          resolve();
+        });
+      }).on('error', (err) => {
+        fs.unlink(dest, () => {});
+        reject(err);
+      });
+    };
+
+    request(url);
+  });
+}
+
+// Extract archive
+function extract(archive, dest, platformInfo) {
+  if (platformInfo.ext === '.tar.gz') {
+    execSync(`tar -xzf "${archive}" -C "${dest}"`, { stdio: 'inherit' });
+  } else if (platformInfo.ext === '.zip') {
+    // Use PowerShell on Windows
+    execSync(`powershell -Command "Expand-Archive -Path '${archive}' -DestinationPath '${dest}' -Force"`, { stdio: 'inherit' });
+  }
+}
+
+async function main() {
+  const platformInfo = getPlatformInfo();
+
+  if (!platformInfo) {
+    console.log('[shodh-memory] Unsupported platform:', process.platform, process.arch);
+    console.log('[shodh-memory] You will need to run the server manually.');
+    return;
+  }
+
+  console.log('[shodh-memory] Installing server binary for', process.platform, process.arch);
+
+  // Create bin directory
+  if (!fs.existsSync(BIN_DIR)) {
+    fs.mkdirSync(BIN_DIR, { recursive: true });
+  }
+
+  const binaryPath = path.join(BIN_DIR, platformInfo.binary);
+
+  // Check if already installed
+  if (fs.existsSync(binaryPath)) {
+    console.log('[shodh-memory] Binary already installed at', binaryPath);
+    return;
+  }
+
+  // Download URL
+  const downloadUrl = `https://github.com/${REPO}/releases/download/v${VERSION}/${platformInfo.name}${platformInfo.ext}`;
+  const archivePath = path.join(BIN_DIR, `${platformInfo.name}${platformInfo.ext}`);
+
+  console.log('[shodh-memory] Downloading from', downloadUrl);
+
+  try {
+    await download(downloadUrl, archivePath);
+    console.log('[shodh-memory] Downloaded archive');
+
+    // Extract
+    extract(archivePath, BIN_DIR, platformInfo);
+    console.log('[shodh-memory] Extracted binary');
+
+    // Clean up archive
+    fs.unlinkSync(archivePath);
+
+    // Make executable (Unix)
+    if (process.platform !== 'win32') {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    console.log('[shodh-memory] Server binary installed at', binaryPath);
+  } catch (err) {
+    console.error('[shodh-memory] Failed to install binary:', err.message);
+    console.log('[shodh-memory] You can manually download from:', `https://github.com/${REPO}/releases`);
+  }
+}
+
+main();