@llmnesia/mcp 0.1.12 → 0.1.13

package/README.md

@@ -48,19 +48,38 @@ The installer:
 1. sets up the native host that bridges the browser extension to your local
    corpus,
 2. copies the server into `~/.llmnesia/bin` so it has a permanent home,
-3. sets up the supported desktop AI apps (Claude Code, Claude Desktop, Cursor,
+3. sets up the supported desktop AI apps (Claude Code, Cursor,
    and Codex/ChatGPT), and
 4. registers that copy using the client's own CLI where available, or with an
    automatic backup before editing its documented user config. It prepares all
    of those standard config paths, so an app installed later does not require
    running setup again.
 
-On Windows, Claude Desktop uses its supported packaged-extension flow instead
-of the legacy JSON config. If Claude is installed, its normal LLMnesia install
-window opens during setup; click **Install** once. Claude can run that extension
-with its built-in Node.js, while the system Node installation continues to run
-the browser helper and other desktop AI integrations. If Claude is installed
-later, run the same LLMnesia setup command once more.
+Claude Desktop on Windows does not provide a supported API for third-party
+installers to add a local desktop extension. LLMnesia therefore leaves any
+existing Claude configuration untouched rather than claiming that Claude has
+been connected.
+
+### Claude Desktop on Windows (current one-time manual step)
+
+Until LLMnesia is available in Claude's extension directory, Claude Desktop on
+Windows has one extra, manual step. First run `install` above so the local
+browser bridge and corpus exist. Then download the official LLMnesia
+`llmnesia.mcpb` desktop-extension file from LLMnesia and use Claude Desktop's
+**Settings → Extensions → Install extension** flow to install it. Fully quit
+and reopen Claude Desktop afterwards.
+
+This is deliberately separate from the npm command: Claude does not provide a
+supported Windows API for another installer to silently add an `.mcpb`
+extension. The command therefore never edits Claude's internal extension state
+or reports a false success. The packaged extension itself is read-only: it can
+search, list, and read the local corpus but cannot modify it.
+
+The future Claude Directory listing is a convenience distribution route, not a
+dependency for the general LLMnesia release. It will replace this one manual
+Claude step with Claude's own in-app install button if Anthropic selects the
+extension. See [`docs/CLAUDE_DESKTOP_RELEASE_PLAN.md`](../docs/CLAUDE_DESKTOP_RELEASE_PLAN.md)
+for the release and directory-submission plan.
 
 The `install` command is the approval to perform those setup steps. It does not
 interrupt setup with a separate prompt for every detected app, and it never
@@ -128,7 +147,7 @@ received data — check it before concluding a chat does not exist.
 | Client | How `install` wires it |
 | --- | --- |
 | Claude Code | Runs `claude mcp add --scope user` with the absolute Node and installed runtime paths when available. Otherwise it writes the documented user-scope `~/.claude.json` entry, so Windows users do not need the `claude` command on PATH. |
-| Claude Desktop | Windows opens Claude's regular packaged-extension installer and removes obsolete LLMnesia JSON entries. macOS keeps the working local JSON registration. |
+| Claude Desktop | macOS uses the working local JSON registration. On Windows, run `install` for browser sync, then install the official `llmnesia.mcpb` once in Claude Desktop; Claude exposes no supported external installation API for custom desktop extensions. |
 | Cursor | Edits `~/.cursor/mcp.json`, preparing it in advance if Cursor is installed later. |
 | Codex / ChatGPT desktop | Runs `codex mcp add` with the absolute runtime paths when available. If the bundled CLI is unavailable, the installer safely edits `~/.codex/config.toml` itself and backs up existing settings first, including preparing it for a later installation. Read-only LLMnesia tools are configured to run without repeated approval prompts; writes still ask. |
 | Others (Windsurf, Zed, LM Studio, …) | Prints the generic stdio block for you to paste. |
@@ -185,6 +204,23 @@ llmnesia-mcp --version     # print the installed version
 
 Questions and bug reports: [hello@llmnesia.com](mailto:hello@llmnesia.com).
 
+## Privacy Policy
+
+The MCP server reads and writes only the LLMnesia corpus stored on the user's
+own computer. It does not upload conversation content, titles, URLs, prompts,
+responses, or search queries to LLMnesia or to any third party, and it makes no
+analytics or advertising requests of its own.
+
+The browser extension separately sends limited, non-content product analytics
+to PostHog. Conversation data and MCP searches are excluded. The complete
+policy explains collection, local storage, third-party processing, retention,
+deletion, and contact details:
+[LLMnesia Privacy Policy](https://www.llmnesia.com/privacy-policy).
+
+The local MCP corpus remains on the device until the user deletes it. Running
+`uninstall` deliberately leaves that corpus intact so uninstalling the helper
+cannot accidentally destroy the user's history.
+
 ## License
 
 MIT — see [LICENSE](./LICENSE).

package/dist/{chunk-MI5RBP7Y.js → chunk-7DAYOGB6.js}

@@ -38,7 +38,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/version.ts
-var VERSION = true ? "0.1.12" : "0.0.0-dev";
+var VERSION = true ? "0.1.13" : "0.0.0-dev";
 
 export {
   __require,

package/dist/{cli-GKHVUCEP.js → cli-OJM47LQR.js}

@@ -15,7 +15,7 @@ import {
   __commonJS,
   __require,
   __toESM
-} from "./chunk-MI5RBP7Y.js";
+} from "./chunk-7DAYOGB6.js";
 
 // ../node_modules/isexe/windows.js
 var require_windows = __commonJS({
@@ -41,15 +41,15 @@ var require_windows = __commonJS({
       }
       return false;
     }
-    function checkStat(stat7, path, options) {
-      if (!stat7.isSymbolicLink() && !stat7.isFile()) {
+    function checkStat(stat6, path, options) {
+      if (!stat6.isSymbolicLink() && !stat6.isFile()) {
         return false;
       }
       return checkPathExt(path, options);
     }
     function isexe(path, options, cb) {
-      fs.stat(path, function(er, stat7) {
-        cb(er, er ? false : checkStat(stat7, path, options));
+      fs.stat(path, function(er, stat6) {
+        cb(er, er ? false : checkStat(stat6, path, options));
       });
     }
     function sync(path, options) {
@@ -66,20 +66,20 @@ var require_mode = __commonJS({
     isexe.sync = sync;
     var fs = __require("fs");
     function isexe(path, options, cb) {
-      fs.stat(path, function(er, stat7) {
-        cb(er, er ? false : checkStat(stat7, options));
+      fs.stat(path, function(er, stat6) {
+        cb(er, er ? false : checkStat(stat6, options));
       });
     }
     function sync(path, options) {
       return checkStat(fs.statSync(path), options);
     }
-    function checkStat(stat7, options) {
-      return stat7.isFile() && checkMode(stat7, options);
+    function checkStat(stat6, options) {
+      return stat6.isFile() && checkMode(stat6, options);
     }
-    function checkMode(stat7, options) {
-      var mod = stat7.mode;
-      var uid = stat7.uid;
-      var gid = stat7.gid;
+    function checkMode(stat6, options) {
+      var mod = stat6.mode;
+      var uid = stat6.uid;
+      var gid = stat6.gid;
       var myUid = options.uid !== void 0 ? options.uid : process.getuid && process.getuid();
       var myGid = options.gid !== void 0 ? options.gid : process.getgid && process.getgid();
       var u = parseInt("100", 8);
@@ -251,8 +251,8 @@ var require_path_key = __commonJS({
     "use strict";
     var pathKey = (options = {}) => {
       const environment = options.env || process.env;
-      const platform5 = options.platform || process.platform;
-      if (platform5 !== "win32") {
+      const platform4 = options.platform || process.platform;
+      if (platform4 !== "win32") {
         return "PATH";
       }
       return Object.keys(environment).reverse().find((key) => key.toUpperCase() === "PATH") || "Path";
@@ -2439,8 +2439,8 @@ var FSWatcher = class extends EventEmitter {
     }
     return this._userIgnored(path, stats);
   }
-  _isntIgnored(path, stat7) {
-    return !this._isIgnored(path, stat7);
+  _isntIgnored(path, stat6) {
+    return !this._isIgnored(path, stat6);
   }
   /**
    * Provides a set of common helpers and properties relating to symlink handling.
@@ -3259,14 +3259,11 @@ async function registerClients(options) {
   );
   if (claudeDesktop) {
     if (osPlatform2 === "win32") {
-      const cleanup = await safe("Claude Desktop", () => unregisterJsonClient("Claude Desktop", claudeDesktop, now));
-      results.push(
-        cleanup.action === "error" ? cleanup : {
-          client: "Claude Desktop",
-          action: "skipped",
-          detail: "Claude Desktop uses the packaged LLMnesia extension on Windows."
-        }
-      );
+      results.push({
+        client: "Claude Desktop",
+        action: "skipped",
+        detail: "Automatic Claude Desktop setup is not available on Windows; existing configuration was left unchanged."
+      });
     } else {
       results.push(
         await safe(
@@ -3788,36 +3785,6 @@ function formatDoctorReport(report) {
   return report.checks.map((c) => `${icon[c.status]} ${c.name}: ${c.detail}`).join("\n");
 }
 
-// src/claudeDesktopExtension.ts
-import { execFile as execFile3 } from "child_process";
-import { access as access2, stat as stat6 } from "fs/promises";
-import { homedir as homedir5, platform as platform4 } from "os";
-import { join as join7 } from "path";
-import { promisify as promisify3 } from "util";
-var execFileAsync3 = promisify3(execFile3);
-async function defaultOpenBundle(bundlePath) {
-  await execFileAsync3("rundll32.exe", ["url.dll,FileProtocolHandler", bundlePath], { windowsHide: true });
-}
-async function promptClaudeDesktopExtension(options) {
-  const home2 = options.home ?? homedir5();
-  const osPlatform2 = options.osPlatform ?? platform4();
-  const bundlePath = join7(options.binDir, "llmnesia.mcpb");
-  if (osPlatform2 !== "win32") {
-    return { status: "unsupported", bundlePath };
-  }
-  const appData = options.appData ?? process.env.APPDATA ?? join7(home2, "AppData", "Roaming");
-  try {
-    if (!(await stat6(join7(appData, "Claude"))).isDirectory()) {
-      return { status: "not-installed", bundlePath };
-    }
-  } catch {
-    return { status: "not-installed", bundlePath };
-  }
-  await access2(bundlePath);
-  await (options.openBundle ?? defaultOpenBundle)(bundlePath);
-  return { status: "opened", bundlePath };
-}
-
 // src/cli.ts
 var USAGE = `llmnesia-mcp ${VERSION}
 
@@ -3890,7 +3857,7 @@ function summarizeClientRegistrations(results) {
   return { connected, prepared, errors };
 }
 function formatInstallSuccess() {
-  return "\nSetup complete.\nFully close and reopen your browser and any desktop AI app you use.\nLLMnesia will be available in each supported desktop AI app you use.\nLLMnesia Settings will confirm when your history is ready.\n";
+  return "\nSetup complete.\nFully close and reopen your browser and any desktop AI app you use.\nLLMnesia will be available in the desktop AI apps connected during setup.\nLLMnesia Settings will confirm when your history is ready.\n";
 }
 async function runInstall(positionals, options, flags) {
   let hadProblems = false;
@@ -3929,19 +3896,6 @@ async function runInstall(positionals, options, flags) {
 `);
   }
   hadProblems ||= registrations.errors.length > 0;
-  if (process.platform === "win32") {
-    try {
-      const claude = await promptClaudeDesktopExtension({ binDir: runtime.binDir });
-      if (claude.status === "opened") {
-        process.stdout.write("Claude opened. Click Install to add LLMnesia.\n");
-      }
-    } catch (err) {
-      process.stderr.write(
-        `Claude Desktop needs one more step: open ${runtime.binDir}\\llmnesia.mcpb and click Install. (${err instanceof Error ? err.message : String(err)})
-`
-      );
-    }
-  }
   if (hadProblems) {
     process.stderr.write("\nSetup needs attention. Fix the message above, then run the same command again.\n");
     return 1;

package/dist/cli.js

@@ -3,7 +3,7 @@ import { createRequire as __llmnesiaCreateRequire } from "node:module";
 const require = __llmnesiaCreateRequire(import.meta.url);
 import {
   VERSION
-} from "./chunk-MI5RBP7Y.js";
+} from "./chunk-7DAYOGB6.js";
 
 // src/nodeDownload.ts
 var NODE_DOWNLOAD_URLS = {
@@ -141,7 +141,7 @@ async function bootstrap() {
     await guideUnsupportedNodeVersion(process.versions.node);
     return 1;
   }
-  const { main } = await import("./cli-GKHVUCEP.js");
+  const { main } = await import("./cli-OJM47LQR.js");
   return main();
 }
 bootstrap().then((code) => {

package/dist/mcp.js

@@ -13,7 +13,7 @@ import {
   __commonJS,
   __export,
   __toESM
-} from "./chunk-MI5RBP7Y.js";
+} from "./chunk-7DAYOGB6.js";
 
 // ../node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
@@ -21632,28 +21632,30 @@ async function runServe() {
       return jsonResult(status);
     })
   );
-  server.registerTool(
-    "save_conversation",
-    {
-      title: "Save conversation",
-      description: "Add or update a conversation in the user's local corpus. Provide platform, title, and the messages; identity is keyed on docId (or platform:sourceId), so re-saving the same conversation updates it in place.",
-      inputSchema: saveConversationSchema.shape,
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        idempotentHint: false,
-        openWorldHint: false
-      }
-    },
-    async (args) => withService(async (service2) => {
-      try {
-        const result = await service2.saveConversation(args);
-        return jsonResult(result);
-      } catch (err) {
-        return errorResult(`save_conversation failed: ${err instanceof Error ? err.message : String(err)}`);
-      }
-    })
-  );
+  if (process.env.LLMNESIA_READ_ONLY !== "1") {
+    server.registerTool(
+      "save_conversation",
+      {
+        title: "Save conversation",
+        description: "Add or update a conversation in the user's local corpus. Provide platform, title, and the messages; identity is keyed on docId (or platform:sourceId), so re-saving the same conversation updates it in place.",
+        inputSchema: saveConversationSchema.shape,
+        annotations: {
+          readOnlyHint: false,
+          destructiveHint: false,
+          idempotentHint: false,
+          openWorldHint: false
+        }
+      },
+      async (args) => withService(async (service2) => {
+        try {
+          const result = await service2.saveConversation(args);
+          return jsonResult(result);
+        } catch (err) {
+          return errorResult(`save_conversation failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+      })
+    );
+  }
   server.server.oninitialized = () => service.start();
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnesia/mcp",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "private": false,
   "type": "module",
   "comment:mcpName": "The MCP Registry's ownership marker: it must equal server.json's `name`, and the namespace must match how you authenticate with mcp-publisher. `com.llmnesia/...` requires DNS auth (a TXT record on llmnesia.com) — see docs/MCP_INSTALLER_BOARD.md.",

package/server.json

@@ -3,13 +3,13 @@
   "name": "com.llmnesia/mcp",
   "title": "LLMnesia",
   "description": "Search your AI chat history from Claude, Cursor, Codex, and other MCP clients.",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@llmnesia/mcp",
-      "version": "0.1.12",
+      "version": "0.1.13",
       "transport": {
         "type": "stdio"
       }