local-mcp 3.0.409 → 3.0.413

package/README.md

@@ -6,6 +6,7 @@
 [![macOS](https://img.shields.io/badge/macOS-13%2B-111111?style=flat-square)](https://local-mcp.com?ref=npm)
 [![Signed](https://img.shields.io/badge/Developer%20ID-notarized-111111?style=flat-square)](https://local-mcp.com?ref=npm)
 [![Privacy](https://img.shields.io/badge/data-stays%20on%20device-2e7d32?style=flat-square)](https://local-mcp.com/en/privacy)
+[![Glama](https://glama.ai/mcp/servers/lanchuske/local-mcp-releases/badge)](https://glama.ai/mcp/servers/lanchuske/local-mcp-releases?ref=npm)
 
 **No cloud. No tokens. No API keys. 100% free.**
 

package/index.js

@@ -279,7 +279,39 @@ function detectManualUninstall() {
   )
 }
 
+// Comandos que este wrapper entiende. Sin argumentos arranca el server MCP por stdio, que es
+// como lo lanzan los clientes de IA — ese camino NO cambia.
+const COMANDOS = ['setup', 'update', 'uninstall', 'status']
+
+function mostrarAyuda() {
+  console.log(`local-mcp — Local MCP Server
+
+Uso:
+  local-mcp              arranca el server MCP por stdio (lo que hace un cliente de IA)
+  local-mcp setup        instala y configura
+  local-mcp status       muestra el estado
+  local-mcp update       limpia el cache del runtime
+  local-mcp uninstall    desinstala
+
+  local-mcp --help       esta ayuda`)
+}
+
 async function main() {
+  // Un argumento que no entendemos NO puede caer al camino por defecto: ese camino descarga
+  // el runtime e instala la app del tray. Medido el 2026-09-20: `local-mcp --help` bajó
+  // teams-proxy e instaló LocalMCPTray.app en ~/Applications, en una máquina donde el usuario
+  // sólo buscaba ayuda de CLI. Un comando de consulta no instala software.
+  //
+  // Sin argumentos sigue arrancando el server, que es como lo invocan los clientes de IA.
+  if (cmd !== undefined && !COMANDOS.includes(cmd)) {
+    const pedidoDeAyuda = ['--help', '-h', 'help'].includes(cmd)
+    mostrarAyuda()
+    if (!pedidoDeAyuda) {
+      console.error(`\nNo conozco el comando "${cmd}".`)
+    }
+    process.exit(pedidoDeAyuda ? 0 : 2)
+  }
+
   if (cmd === 'setup') {
     // Clear uninstall sentinel — user explicitly wants to (re-)install
     clearUninstallSentinels()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "local-mcp",
-  "version": "3.0.409",
-  "description": "Let ChatGPT, Claude, Cursor & any MCP client actually use your Mac — read & reply to email, manage your calendar, text over iMessage, find files, work with Teams, Slack & Office. On your Mac, no API keys, free.",
+  "version": "3.0.413",
+  "description": "Let ChatGPT, Claude, Cursor & any MCP client actually use your Mac or Windows PC — read & reply to email, manage your calendar, text over iMessage, find files, work with Teams, Slack & Office. Runs locally, no API keys, free.",
   "main": "index.js",
   "bin": {
     "local-mcp": "index.js"

package/setup.js

@@ -836,6 +836,20 @@ async function _associateEmail(email, token) {
   })
 }
 
+// Where install-ref is persisted for the LONG-RUNNING process to read back on every
+// heartbeat. NOT the same directory on every platform: Mac's Swift heartbeat
+// (HeartbeatManager.swift installRef) reads ~/.local/share/local-mcp/install-ref, no
+// /bin — go-server's config.InstallRef() (Windows AND Linux) reads
+// <cache dir>/install-ref WITH /bin, via config.Dir(), which is the exact directory
+// download.js's CACHE_DIR already computes per platform. Measured live on Windows
+// 2026-09-18: this used to hardcode the darwin-shaped path unconditionally, so a
+// Windows (or Linux) npm/npx install persisted its ref where nothing ever read it
+// back — resolveInstallRef's file/env/ADS ladder never even looked there.
+function _installRefDir(platform = process.platform, home = HOME, cacheDir = download.CACHE_DIR) {
+  if (platform === 'darwin') return path.join(home, '.local', 'share', 'local-mcp')
+  return cacheDir
+}
+
 // On darwin the anon cloud_token is persisted in config.json (cfgFile), which the Swift
 // tray already reads. Off darwin, the go-server reads it EXCLUSIVELY from
 // getCacheDir()/.cloud-token as a plain trimmed string (tunnel.go:454,513-523) — it never
@@ -1022,7 +1036,7 @@ function _pingInstall(clients, method, email = '', binaryVersion = '') {
     // machine_id + ref in one event (machine-level attribution, deduped, and it
     // closes install events that fire before machine_id exists). Best-effort.
     try {
-      const _refDir = path.join(HOME, '.local', 'share', 'local-mcp')
+      const _refDir = _installRefDir()
       fs.mkdirSync(_refDir, { recursive: true })
       fs.writeFileSync(path.join(_refDir, 'install-ref'), _getRef())
     } catch {}
@@ -1172,7 +1186,7 @@ module.exports = {
   CLIENTS_REPORT_SCHEMA,
   _notSupportedOnPlatformResult,
   _launcherSpawnSpec, _writeLaunchScript, _writeLaunchSpec,
-  _getMachineId, _healthCheckSpec, _localMcpConfigDir,
+  _getMachineId, _healthCheckSpec, _localMcpConfigDir, _installRefDir,
   _cloudTokenPath, _readCachedCloudToken, _writeCloudToken, _registerAnonToken,
   _autoLaunchClient, _fetchClientsCatalog,
 }