@mnemoverse/mcp-memory-server 0.3.1 → 0.3.3

package/docs/snippets/claude-code.md

@@ -1,9 +0,0 @@
-<!-- AUTO-GENERATED from src/configs/source.json. Run `npm run generate:configs`. Do not edit by hand. -->
-
-**Claude Code** — add via CLI:
-
-```bash
-claude mcp add mnemoverse \
-  -e MNEMOVERSE_API_KEY=mk_live_YOUR_KEY \
-  -- npx -y @mnemoverse/mcp-memory-server@latest
-```

package/docs/snippets/claude-desktop.md

@@ -1,20 +0,0 @@
-<!-- AUTO-GENERATED from src/configs/source.json. Run `npm run generate:configs`. Do not edit by hand. -->
-
-**Claude Desktop** — add to `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "mnemoverse": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@mnemoverse/mcp-memory-server@latest"
-      ],
-      "env": {
-        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY"
-      }
-    }
-  }
-}
-```

package/docs/snippets/cursor.md

@@ -1,20 +0,0 @@
-<!-- AUTO-GENERATED from src/configs/source.json. Run `npm run generate:configs`. Do not edit by hand. -->
-
-**Cursor** — add to `.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "mnemoverse": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@mnemoverse/mcp-memory-server@latest"
-      ],
-      "env": {
-        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY"
-      }
-    }
-  }
-}
-```

package/docs/snippets/vscode.md

@@ -1,21 +0,0 @@
-<!-- AUTO-GENERATED from src/configs/source.json. Run `npm run generate:configs`. Do not edit by hand. -->
-
-**VS Code** — add to `.vscode/mcp.json` (note: VS Code uses `servers`, not `mcpServers`):
-
-```json
-{
-  "servers": {
-    "mnemoverse": {
-      "type": "stdio",
-      "command": "npx",
-      "args": [
-        "-y",
-        "@mnemoverse/mcp-memory-server@latest"
-      ],
-      "env": {
-        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY"
-      }
-    }
-  }
-}
-```

package/docs/snippets/windsurf.md

@@ -1,20 +0,0 @@
-<!-- AUTO-GENERATED from src/configs/source.json. Run `npm run generate:configs`. Do not edit by hand. -->
-
-**Windsurf** — add to `~/.codeium/windsurf/mcp_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "mnemoverse": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@mnemoverse/mcp-memory-server@latest"
-      ],
-      "env": {
-        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY"
-      }
-    }
-  }
-}
-```

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)`,
-  );
-}