@mnemoverse/mcp-memory-server 0.3.0 → 0.3.2

package/scripts/generate-configs.mjs

@@ -191,16 +191,128 @@ ${envAssignments}
   return yaml;
 }
 
+// ─── Markdown partials ────────────────────────────────────────────────────────
+//
+// These are the SAME install snippets that ship to:
+//   - mcp-memory-server/README.md (assembled into the INSTALL_SNIPPETS block)
+//   - mnemoverse-docs (synced via cross-repo workflow → docs/.snippets/)
+//
+// One channel = one partial = one place to edit (source.json). The README's
+// install block is rebuilt from these partials in-place — never edit it by hand.
+
+const PARTIAL_HEADER =
+  "<!-- AUTO-GENERATED from src/configs/source.json. Run `npm run generate:configs`. Do not edit by hand. -->\n\n";
+
+function snippetClaudeCodeCli() {
+  // shell command, multiline with backslash continuations
+  return (
+    "**Claude Code** — add via CLI:\n\n" +
+    "```bash\n" +
+    genClaudeCodeCli().trim() +
+    "\n```\n"
+  );
+}
+
+function snippetMcpServersJson(label, configPath) {
+  // Cursor / Claude Desktop / Windsurf — shared mcpServers shape
+  const json = JSON.stringify(genMcpServersFormat(), null, 2);
+  return (
+    `**${label}** — add to \`${configPath}\`:\n\n` +
+    "```json\n" +
+    json +
+    "\n```\n"
+  );
+}
+
+function snippetVscode() {
+  // VS Code uses `servers` (not `mcpServers`) and requires `type: "stdio"`
+  const json = JSON.stringify(genVscodeFormat(), null, 2);
+  return (
+    "**VS Code** — add to `.vscode/mcp.json` (note: VS Code uses `servers`, not `mcpServers`):\n\n" +
+    "```json\n" +
+    json +
+    "\n```\n"
+  );
+}
+
+const WHY_LATEST_NOTE =
+  "> Why `@latest`? Bare `npx @mnemoverse/mcp-memory-server` is cached indefinitely by npm and stops re-checking the registry. The `@latest` suffix forces a metadata lookup on every Claude Code / Cursor / VS Code session start (~100-300ms), so you always pick up new releases.";
+
+/**
+ * Build the README install block contents (without the START/END markers).
+ * The order here matches the README — change here, README rewrites itself.
+ */
+function readmeInstallBlock() {
+  return [
+    snippetClaudeCodeCli(),
+    snippetMcpServersJson("Cursor", ".cursor/mcp.json"),
+    snippetVscode(),
+    snippetMcpServersJson("Windsurf", "~/.codeium/windsurf/mcp_config.json"),
+    WHY_LATEST_NOTE,
+  ].join("\n");
+}
+
+// ─── README in-place rewriter ─────────────────────────────────────────────────
+
+const README_START =
+  "<!-- INSTALL_SNIPPETS_START — generated from src/configs/source.json. Run `npm run generate:configs` to refresh. Do not edit by hand. -->";
+const README_END = "<!-- INSTALL_SNIPPETS_END -->";
+
+/**
+ * Take current README content + the freshly assembled install block and return
+ * the rewritten README content. Idempotent.
+ *
+ * Throws if the markers are missing — that means a contributor stripped them
+ * out and we don't know where to inject the snippets, so we fail loudly
+ * instead of silently doing the wrong thing.
+ */
+function rewriteReadme(currentReadme, freshBlock) {
+  const startIdx = currentReadme.indexOf("<!-- INSTALL_SNIPPETS_START");
+  const endIdx = currentReadme.indexOf("<!-- INSTALL_SNIPPETS_END -->");
+
+  if (startIdx === -1 || endIdx === -1) {
+    throw new Error(
+      "README.md is missing the INSTALL_SNIPPETS_START / INSTALL_SNIPPETS_END markers.\n" +
+        "These markers tell the generator where to inject the install snippets.\n" +
+        "Restore them around the install section and re-run `npm run generate:configs`.",
+    );
+  }
+  if (startIdx >= endIdx) {
+    throw new Error(
+      "README.md INSTALL_SNIPPETS_END marker appears before INSTALL_SNIPPETS_START.",
+    );
+  }
+
+  const before = currentReadme.slice(0, startIdx);
+  const after = currentReadme.slice(endIdx + README_END.length);
+
+  return `${before}${README_START}\n\n${freshBlock}\n\n${README_END}${after}`;
+}
+
 /**
  * Official MCP Registry server.json.
  *
  * https://registry.modelcontextprotocol.io/
- * Schema: https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json
+ * Schema: https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json
+ *
+ * The canonical shape was verified empirically by running `mcp-publisher init`
+ * in a sandbox and matching its output. Key differences vs the older
+ * 2025-09-29 schema: registryName → registryType, packages[0].name →
+ * packages[0].identifier, new required `transport` object, dropped
+ * runtimeArguments (the registry runtime builds its own launch command
+ * from identifier + version), and environmentVariables entries gained a
+ * `format` field.
+ *
+ * The `@latest` pin we use in docs/configs/* does NOT belong here — that
+ * is for direct JSON-snippet installs where users stay on the bleeding
+ * edge. Registry-installed clients get the exact pinned version from
+ * server.json.version and we re-publish on each npm release to advance
+ * them.
  */
 function genServerJson() {
   return {
     $schema:
-      "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
+      "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
     name: "io.github.mnemoverse/mcp-memory-server",
     description: source.description,
     repository: {
@@ -210,14 +322,17 @@ function genServerJson() {
     version: PACKAGE_VERSION,
     packages: [
       {
-        registryName: source.package.registry,
-        name: source.package.name,
+        registryType: source.package.registry,
+        identifier: source.package.name,
         version: PACKAGE_VERSION,
-        runtimeArguments: source.args.slice(1), // skip "-y"
+        transport: {
+          type: "stdio",
+        },
         environmentVariables: Object.entries(source.env).map(([key, meta]) => ({
           name: key,
           description: meta.description,
           isRequired: meta.required ?? false,
+          format: "string",
           isSecret: meta.secret ?? false,
         })),
       },
@@ -264,6 +379,35 @@ const OUTPUTS = [
     path: "server.json",
     content: JSON.stringify(genServerJson(), null, 2) + "\n",
   },
+  // ─── Markdown partials (consumed by README + mnemoverse-docs) ──────────────
+  {
+    path: "docs/snippets/claude-code.md",
+    content: PARTIAL_HEADER + snippetClaudeCodeCli(),
+  },
+  {
+    path: "docs/snippets/cursor.md",
+    content:
+      PARTIAL_HEADER + snippetMcpServersJson("Cursor", ".cursor/mcp.json"),
+  },
+  {
+    path: "docs/snippets/claude-desktop.md",
+    content:
+      PARTIAL_HEADER +
+      snippetMcpServersJson("Claude Desktop", "claude_desktop_config.json"),
+  },
+  {
+    path: "docs/snippets/vscode.md",
+    content: PARTIAL_HEADER + snippetVscode(),
+  },
+  {
+    path: "docs/snippets/windsurf.md",
+    content:
+      PARTIAL_HEADER +
+      snippetMcpServersJson(
+        "Windsurf",
+        "~/.codeium/windsurf/mcp_config.json",
+      ),
+  },
 ];
 
 // ─── Write files ─────────────────────────────────────────────────────────────
@@ -297,10 +441,55 @@ for (const { path, content } of OUTPUTS) {
   written++;
 }
 
+// ─── README install block (in-place rewrite) ────────────────────────────────
+//
+// Special-cased because README is read-modify-write — we can only update the
+// region between the INSTALL_SNIPPETS markers, the rest of the file is human-
+// authored prose.
+
+const README_PATH = resolve(ROOT, "README.md");
+
+if (!existsSync(README_PATH)) {
+  console.error(`✗ README.md not found at ${README_PATH}`);
+  process.exit(1);
+}
+
+const currentReadme = readFileSync(README_PATH, "utf8");
+let freshReadme;
+try {
+  freshReadme = rewriteReadme(currentReadme, readmeInstallBlock());
+} catch (err) {
+  console.error("✗ Cannot rewrite README.md install block:");
+  console.error("  " + (err.message || err).split("\n").join("\n  "));
+  process.exit(1);
+}
+
+if (currentReadme === freshReadme) {
+  unchanged++;
+} else if (checkMode) {
+  console.error("✗ Drift detected: README.md install block is stale");
+  console.error(
+    "  The INSTALL_SNIPPETS_START/END region in README.md does not match",
+  );
+  console.error(
+    "  what the generator would emit from src/configs/source.json.",
+  );
+  console.error("  Run `npm run generate:configs` and commit the result.");
+  process.exit(1);
+} else {
+  writeFileSync(README_PATH, freshReadme, "utf8");
+  console.log("✓ Generated README.md (install block)");
+  written++;
+}
+
+const totalArtifacts = OUTPUTS.length + 1; // +1 for README
+
 if (checkMode) {
-  console.log(`✓ All ${OUTPUTS.length} configs in sync with source.json`);
+  console.log(
+    `✓ All ${totalArtifacts} artifacts in sync with source.json`,
+  );
 } else {
   console.log(
-    `\nDone: ${written} written, ${unchanged} unchanged (${OUTPUTS.length} total)`,
+    `\nDone: ${written} written, ${unchanged} unchanged (${totalArtifacts} total)`,
   );
 }

package/scripts/install-hooks.mjs

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/**
+ * install-hooks.mjs
+ *
+ * Installs the optional pre-push hook for local drift detection. The hook
+ * runs `npm run verify:configs` before every push and aborts if any of the
+ * 15 generated artifacts is out of sync with src/configs/source.json.
+ *
+ * The hook is per-clone (.git/hooks/ is not committed) and opt-in. CI is
+ * the authoritative gate — see .github/workflows/verify-configs.yml.
+ *
+ * Usage: npm run install-hooks
+ */
+
+import {
+  writeFileSync,
+  chmodSync,
+  existsSync,
+  mkdirSync,
+} from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, "..");
+const HOOKS_DIR = resolve(ROOT, ".git/hooks");
+const HOOK_PATH = resolve(HOOKS_DIR, "pre-push");
+
+if (!existsSync(resolve(ROOT, ".git"))) {
+  console.error(
+    "✗ Not a git repo (no .git directory found at " + ROOT + ").",
+  );
+  console.error("  Cannot install pre-push hook.");
+  process.exit(1);
+}
+
+mkdirSync(HOOKS_DIR, { recursive: true });
+
+const HOOK_BODY = `#!/usr/bin/env bash
+# Auto-generated by scripts/install-hooks.mjs.
+# Aborts the push if any of the 15 distribution artifacts has drifted from
+# src/configs/source.json. Re-run install-hooks after pulling generator changes.
+#
+# To bypass for a one-off (NOT recommended for branches targeting main):
+#   git push --no-verify
+
+set -e
+
+# Find repo root so the hook works regardless of where 'git push' was invoked.
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+cd "$REPO_ROOT"
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "pre-push: node not found in PATH; skipping drift check"
+  exit 0
+fi
+
+echo "pre-push: verifying distribution config drift..."
+if ! node scripts/generate-configs.mjs --check; then
+  echo ""
+  echo "✗ Push aborted: distribution configs are out of sync with src/configs/source.json"
+  echo "  Run \\\`npm run generate:configs\\\` to fix, commit the result, then push again."
+  echo "  See CONTRIBUTING.md for details."
+  exit 1
+fi
+`;
+
+writeFileSync(HOOK_PATH, HOOK_BODY, "utf8");
+chmodSync(HOOK_PATH, 0o755);
+
+console.log("✓ Installed pre-push hook at " + HOOK_PATH);
+console.log("  It will run `node scripts/generate-configs.mjs --check`");
+console.log("  before every push and abort on drift.");
+console.log("");
+console.log("  To remove: rm " + HOOK_PATH);
+console.log("  To bypass once: git push --no-verify");

package/server.json

@@ -1,25 +1,26 @@
 {
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.mnemoverse/mcp-memory-server",
-  "description": "Persistent memory for AI agents — write once, recall anywhere across all your AI tools",
+  "description": "Shared AI memory across Claude, Cursor, VS Code, ChatGPT. Write once, recall anywhere.",
   "repository": {
     "url": "https://github.com/mnemoverse/mcp-memory-server",
     "source": "github"
   },
-  "version": "0.3.0",
+  "version": "0.3.2",
   "packages": [
     {
-      "registryName": "npm",
-      "name": "@mnemoverse/mcp-memory-server",
-      "version": "0.3.0",
-      "runtimeArguments": [
-        "@mnemoverse/mcp-memory-server"
-      ],
+      "registryType": "npm",
+      "identifier": "@mnemoverse/mcp-memory-server",
+      "version": "0.3.2",
+      "transport": {
+        "type": "stdio"
+      },
       "environmentVariables": [
         {
           "name": "MNEMOVERSE_API_KEY",
           "description": "Your Mnemoverse API key (starts with mk_live_). Get one free at https://console.mnemoverse.com",
           "isRequired": true,
+          "format": "string",
           "isSecret": true
         }
       ]

package/smithery.yaml

@@ -17,7 +17,7 @@ startCommand:
     |-
     (config) => ({
       command: 'npx',
-      args: ["-y","@mnemoverse/mcp-memory-server"],
+      args: ["-y","@mnemoverse/mcp-memory-server@latest"],
       env: {
         MNEMOVERSE_API_KEY: config.mnemoverseApiKey,
       }

package/src/configs/source.json

@@ -2,10 +2,10 @@
   "$comment": "SINGLE SOURCE OF TRUTH for all distribution channel configs. Edit this file → run `npm run generate:configs` → all 9+ artifacts regenerate. CI verifies committed artifacts match source.",
   "name": "mnemoverse",
   "displayName": "Mnemoverse Memory",
-  "description": "Persistent memory for AI agents — write once, recall anywhere across all your AI tools",
+  "description": "Shared AI memory across Claude, Cursor, VS Code, ChatGPT. Write once, recall anywhere.",
   "type": "stdio",
   "command": "npx",
-  "args": ["-y", "@mnemoverse/mcp-memory-server"],
+  "args": ["-y", "@mnemoverse/mcp-memory-server@latest"],
   "env": {
     "MNEMOVERSE_API_KEY": {
       "value": "mk_live_YOUR_KEY",