@mnemoverse/mcp-memory-server 0.3.2 → 0.3.3

package/llms.txt

@@ -1,52 +0,0 @@
-# Mnemoverse MCP Memory Server
-
-> Persistent AI memory via Model Context Protocol. Store and recall memories across sessions.
-
-## Tools
-
-### memory_write
-Store a memory — insight, pattern, preference, or fact. Persists across sessions.
-
-Parameters:
-- content (string, required): The memory to store — what happened, what was learned. 1-10000 chars.
-- concepts (string[], optional): Key concepts for linking related memories. Example: ["deploy", "friday", "staging"]
-- domain (string, optional): Namespace to organize memories. Example: "engineering", "user:alice"
-
-Returns: {stored: boolean, atom_id: string|null, importance: number, reason: string}
-
-### memory_read
-Search memories by natural language query. Returns most relevant stored memories ranked by relevance.
-
-Parameters:
-- query (string, required): Natural language query — what are you looking for? 1-5000 chars.
-- top_k (integer, optional, default 5): Max results to return. Range: 1-50.
-- domain (string, optional): Filter by domain namespace.
-
-Returns: List of memories with relevance scores, concepts, and domain.
-
-### memory_feedback
-Report whether a retrieved memory was helpful. Positive feedback strengthens recall. Negative lets memories fade.
-
-Parameters:
-- atom_ids (string[], required): IDs of memories to give feedback on.
-- outcome (number, required): How helpful? Range: -1.0 (harmful) to 1.0 (very helpful).
-
-Returns: {updated_count: number}
-
-### memory_stats
-Get memory statistics — count, domains, quality scores.
-
-Parameters: none
-
-Returns: {total_atoms, episodes, prototypes, hebbian_edges, domains, avg_valence, avg_importance}
-
-## Setup
-Environment: MNEMOVERSE_API_KEY (required), MNEMOVERSE_API_URL (optional, default https://core.mnemoverse.com/api/v1)
-Transport: stdio
-Command: npx @mnemoverse/mcp-memory-server
-
-## Links
-- Docs: https://mnemoverse.com/docs/api/mcp-server
-- API Reference: https://mnemoverse.com/docs/api/reference
-- Console: https://console.mnemoverse.com
-- Source: https://github.com/mnemoverse/mcp-memory-server

package/scripts/generate-configs.mjs

@@ -1,495 +0,0 @@
-#!/usr/bin/env node
-/**
- * generate-configs.mjs
- *
- * Single source of truth → all distribution channel configs.
- *
- * Reads: src/configs/source.json
- * Writes: docs/configs/*, smithery.yaml, server.json
- *
- * Usage:
- *   node scripts/generate-configs.mjs            # generate
- *   node scripts/generate-configs.mjs --check    # CI: regenerate + diff (fail if changed)
- *
- * When you add a new distribution channel, add a new generator function below.
- * Never edit generated files by hand — they will be overwritten.
- */
-
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { execSync } from "node:child_process";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const ROOT = resolve(__dirname, "..");
-
-// ─── Load source ─────────────────────────────────────────────────────────────
-
-const SOURCE_PATH = resolve(ROOT, "src/configs/source.json");
-const source = JSON.parse(readFileSync(SOURCE_PATH, "utf8"));
-
-const PACKAGE_VERSION = JSON.parse(
-  readFileSync(resolve(ROOT, "package.json"), "utf8"),
-).version;
-
-// Helper: extract { KEY: "value" } from source.env (which has nested {value, description, ...})
-function envValues(envObj) {
-  const result = {};
-  for (const [key, meta] of Object.entries(envObj)) {
-    result[key] = meta.value;
-  }
-  return result;
-}
-
-const ENV_VALUES = envValues(source.env);
-
-// ─── Generators ──────────────────────────────────────────────────────────────
-
-/**
- * Cursor / Claude Desktop / Windsurf format (mcpServers key, stdio).
- */
-function genMcpServersFormat() {
-  return {
-    mcpServers: {
-      [source.name]: {
-        command: source.command,
-        args: source.args,
-        env: ENV_VALUES,
-      },
-    },
-  };
-}
-
-/**
- * VS Code (Copilot Chat) format — uses `servers` key (not `mcpServers`).
- */
-function genVscodeFormat() {
-  return {
-    servers: {
-      [source.name]: {
-        type: source.type,
-        command: source.command,
-        args: source.args,
-        env: ENV_VALUES,
-      },
-    },
-  };
-}
-
-/**
- * Cursor deep link.
- *
- * Format: cursor://anysphere.cursor-deeplink/mcp/install?name=NAME&config=BASE64
- * The base64 payload is the inner server object (NOT wrapped in mcpServers).
- */
-function genCursorDeepLink() {
-  const inner = {
-    command: source.command,
-    args: source.args,
-    env: ENV_VALUES,
-  };
-  const config = Buffer.from(JSON.stringify(inner)).toString("base64");
-  return `cursor://anysphere.cursor-deeplink/mcp/install?name=${encodeURIComponent(
-    source.name,
-  )}&config=${config}`;
-}
-
-/**
- * VS Code deep link.
- *
- * Format: vscode:mcp/install?{URL_ENCODED_JSON}
- * The JSON contains name + the server object (not wrapped in `servers`).
- */
-function genVscodeDeepLink() {
-  const inner = {
-    name: source.name,
-    type: source.type,
-    command: source.command,
-    args: source.args,
-    env: ENV_VALUES,
-  };
-  return `vscode:mcp/install?${encodeURIComponent(JSON.stringify(inner))}`;
-}
-
-/**
- * Claude Code CLI command.
- *
- * Format: claude mcp add NAME -e KEY=VAL ... -- command args...
- */
-function genClaudeCodeCli() {
-  const envFlags = Object.entries(ENV_VALUES)
-    .map(([k, v]) => `  -e ${k}=${v}`)
-    .join(" \\\n");
-  return `claude mcp add ${source.name} \\\n${envFlags} \\\n  -- ${source.command} ${source.args.join(" ")}\n`;
-}
-
-/**
- * Smithery.ai config — custom yaml with configSchema + commandFunction.
- *
- * Smithery shows configSchema fields to user as form, then calls commandFunction(config)
- * to build the launch command.
- */
-function genSmitheryYaml() {
-  // Build configSchema properties from source.env
-  const schemaProperties = {};
-  const required = [];
-  const camelCaseEnvMap = {}; // Smithery uses camelCase keys, then we map back to ENV_VAR
-
-  for (const [envKey, meta] of Object.entries(source.env)) {
-    // Convert MNEMOVERSE_API_KEY → mnemoverseApiKey
-    const camelKey = envKey
-      .toLowerCase()
-      .split("_")
-      .map((part, i) =>
-        i === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1),
-      )
-      .join("");
-
-    camelCaseEnvMap[camelKey] = envKey;
-    schemaProperties[camelKey] = {
-      type: "string",
-      description: meta.description,
-    };
-    if (meta.required) required.push(camelKey);
-  }
-
-  // Build commandFunction body
-  const envAssignments = Object.entries(camelCaseEnvMap)
-    .map(([camel, envVar]) => `        ${envVar}: config.${camel},`)
-    .join("\n");
-
-  const yaml = `# Smithery configuration — AUTO-GENERATED from src/configs/source.json
-# Do not edit by hand. Run \`npm run generate:configs\` to regenerate.
-# Docs: https://smithery.ai/docs/build/project-config/smithery.yaml
-
-startCommand:
-  type: ${source.type}
-  configSchema:
-    type: object
-    required:
-${required.map((k) => `      - ${k}`).join("\n")}
-    properties:
-${Object.entries(schemaProperties)
-  .map(
-    ([key, prop]) => `      ${key}:
-        type: ${prop.type}
-        description: |
-          ${prop.description}`,
-  )
-  .join("\n")}
-  commandFunction:
-    |-
-    (config) => ({
-      command: '${source.command}',
-      args: ${JSON.stringify(source.args)},
-      env: {
-${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-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-12-11/server.schema.json",
-    name: "io.github.mnemoverse/mcp-memory-server",
-    description: source.description,
-    repository: {
-      url: source.metadata.repository,
-      source: "github",
-    },
-    version: PACKAGE_VERSION,
-    packages: [
-      {
-        registryType: source.package.registry,
-        identifier: source.package.name,
-        version: PACKAGE_VERSION,
-        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,
-        })),
-      },
-    ],
-  };
-}
-
-// ─── Output ──────────────────────────────────────────────────────────────────
-
-const OUTPUTS = [
-  {
-    path: "docs/configs/cursor.json",
-    content: JSON.stringify(genMcpServersFormat(), null, 2) + "\n",
-  },
-  {
-    path: "docs/configs/claude-desktop.json",
-    content: JSON.stringify(genMcpServersFormat(), null, 2) + "\n",
-  },
-  {
-    path: "docs/configs/windsurf.json",
-    content: JSON.stringify(genMcpServersFormat(), null, 2) + "\n",
-  },
-  {
-    path: "docs/configs/vscode.json",
-    content: JSON.stringify(genVscodeFormat(), null, 2) + "\n",
-  },
-  {
-    path: "docs/configs/cursor-deep-link.txt",
-    content: genCursorDeepLink() + "\n",
-  },
-  {
-    path: "docs/configs/vscode-deep-link.txt",
-    content: genVscodeDeepLink() + "\n",
-  },
-  {
-    path: "docs/configs/claude-code-cli.sh",
-    content: "#!/usr/bin/env bash\n" + genClaudeCodeCli(),
-  },
-  {
-    path: "smithery.yaml",
-    content: genSmitheryYaml(),
-  },
-  {
-    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 ─────────────────────────────────────────────────────────────
-
-const checkMode = process.argv.includes("--check");
-
-let written = 0;
-let unchanged = 0;
-
-for (const { path, content } of OUTPUTS) {
-  const fullPath = resolve(ROOT, path);
-  mkdirSync(dirname(fullPath), { recursive: true });
-
-  const existing = existsSync(fullPath) ? readFileSync(fullPath, "utf8") : "";
-  if (existing === content) {
-    unchanged++;
-    continue;
-  }
-
-  if (checkMode) {
-    console.error(`✗ Drift detected: ${path}`);
-    console.error("  Expected (regenerated):");
-    console.error("  " + content.slice(0, 200).split("\n").join("\n  "));
-    console.error("  Got (committed):");
-    console.error("  " + existing.slice(0, 200).split("\n").join("\n  "));
-    process.exit(1);
-  }
-
-  writeFileSync(fullPath, content, "utf8");
-  console.log(`✓ Generated ${path}`);
-  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 ${totalArtifacts} artifacts in sync with source.json`,
-  );
-} else {
-  console.log(
-    `\nDone: ${written} written, ${unchanged} unchanged (${totalArtifacts} total)`,
-  );
-}

package/scripts/install-hooks.mjs

@@ -1,76 +0,0 @@
-#!/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,29 +0,0 @@
-{
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "io.github.mnemoverse/mcp-memory-server",
-  "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.2",
-  "packages": [
-    {
-      "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

@@ -1,24 +0,0 @@
-# Smithery configuration — AUTO-GENERATED from src/configs/source.json
-# Do not edit by hand. Run `npm run generate:configs` to regenerate.
-# Docs: https://smithery.ai/docs/build/project-config/smithery.yaml
-
-startCommand:
-  type: stdio
-  configSchema:
-    type: object
-    required:
-      - mnemoverseApiKey
-    properties:
-      mnemoverseApiKey:
-        type: string
-        description: |
-          Your Mnemoverse API key (starts with mk_live_). Get one free at https://console.mnemoverse.com
-  commandFunction:
-    |-
-    (config) => ({
-      command: 'npx',
-      args: ["-y","@mnemoverse/mcp-memory-server@latest"],
-      env: {
-        MNEMOVERSE_API_KEY: config.mnemoverseApiKey,
-      }
-    })