local-mcp 3.0.370 → 3.0.372

package/README.md

@@ -1,6 +1,6 @@
 # Local MCP
 
-> **The only Mac MCP you can use from ChatGPT & Claude.ai on the web** — plus 271 local tools for Claude Desktop, Cursor, Windsurf, VS Code & Zed. Connect any AI to Mail, Calendar, Contacts, iMessage, Teams, Slack, WhatsApp, Signal, OneDrive, Google Drive, Microsoft 365, Notes, Reminders, OmniFocus, Safari, Chrome, Word/Excel/PowerPoint and more. 100% local, no API keys, free — your data never leaves your machine.
+> **The only Mac MCP you can use from ChatGPT & Claude.ai on the web** — plus 215+ local tools for Claude Desktop, Cursor, Windsurf, VS Code & Zed. Connect any AI to Mail, Calendar, Contacts, iMessage, Teams, Slack, WhatsApp, Signal, OneDrive, Google Drive, Microsoft 365, Notes, Reminders, OmniFocus, Safari, Chrome, Word/Excel/PowerPoint and more. 100% local, no API keys, free — your data never leaves your machine.
 
 [![npm](https://img.shields.io/npm/v/local-mcp?style=flat-square&label=npm)](https://www.npmjs.com/package/local-mcp)
 [![macOS](https://img.shields.io/badge/macOS-13%2B-111111?style=flat-square)](https://local-mcp.com?ref=npm)
@@ -74,7 +74,7 @@ LMCP runs a native MCP server that bridges your Mac apps to any AI client:
 
  
 
-## All 271 tools (macOS)
+## Tool catalog (macOS)
 
 Email (12): `list_accounts` `list_email_accounts` `list_emails` `read_email` `send_email` `reply_email` `create_draft` `search_emails` `move_email` `save_attachment` `create_email_folder` `list_email_folders`
 

package/download.js

@@ -18,6 +18,15 @@ function extractTar(tarPath, destDir) {
   const tarBin = process.platform === 'win32'
     ? path.join(process.env.SystemRoot || 'C:\\Windows', 'System32', 'tar.exe')
     : 'tar'
+  // Windows 10 1803+ ships bsdtar at System32\tar.exe. On an older/stripped Windows
+  // it's absent — fail with a clear cause instead of a bare execFileSync ENOENT that
+  // the caller would otherwise mask as "not yet available" (#1256).
+  if (process.platform === 'win32' && !fs.existsSync(tarBin)) {
+    throw new Error(
+      `tar.exe not found at ${tarBin} — Windows 10 1803+ (with built-in bsdtar) is ` +
+      `required to unpack the LMCP server.`
+    )
+  }
   execFileSync(tarBin, ['-xzf', tarPath, '-C', destDir], { stdio: 'pipe' })
 }
 
@@ -122,7 +131,7 @@ async function getLatestBinary() {
 /**
  * Descarga un archivo con barra de progreso.
  */
-async function downloadFile(url, destPath) {
+function downloadOnce(url, destPath) {
   return new Promise((resolve, reject) => {
     const file = fs.createWriteStream(destPath)
     const proto = url.startsWith('https') ? https : http
@@ -164,6 +173,27 @@ async function downloadFile(url, destPath) {
   })
 }
 
+// Retry transient download failures (timeouts, resets, 5xx). A 4xx is permanent —
+// a missing/forbidden artifact won't appear on a retry, so fail fast and let the
+// caller decide whether that means "not yet published". Backoff grows per attempt.
+async function downloadFile(url, destPath) {
+  const maxAttempts = 3
+  let lastErr
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await downloadOnce(url, destPath)
+    } catch (err) {
+      lastErr = err
+      if (/HTTP 4\d\d/.test(err.message)) throw err // permanent, don't retry
+      if (attempt < maxAttempts) {
+        process.stderr.write(`\n  Download failed (${err.message}) — retrying (${attempt}/${maxAttempts - 1})...\n`)
+        await new Promise(r => setTimeout(r, 1000 * attempt))
+      }
+    }
+  }
+  throw lastErr
+}
+
 /**
  * Asegura que el binario esté descargado y listo.
  * @returns {Promise<{binPath: string}>}
@@ -233,11 +263,20 @@ async function ensureBinary() {
       extractTar(tarPath, CACHE_DIR)
       fs.unlinkSync(tarPath)
     } catch (err) {
-      // Go binary not yet published for this version — fall back to message
       try { fs.unlinkSync(tarPath) } catch {}
+      // Only a 404 means the artifact for this version/arch genuinely isn't published.
+      // Every other failure (network, missing tar.exe, disk) is an environment problem —
+      // surface it verbatim so it's diagnosable. Masking ALL failures as "in preview" sent
+      // us chasing a backend version-alignment ghost that didn't exist (#1256): the artifact
+      // was published, valid and hash-correct; the client just failed to fetch/unpack it.
+      if (/HTTP 404/.test(err.message)) {
+        throw new Error(
+          `LMCP ${platformVersion} is not yet available for ${arch}.\n` +
+          `The Windows/Linux Go server is in preview — check https://local-mcp.com for updates.`
+        )
+      }
       throw new Error(
-        `LMCP ${platformVersion} is not yet available for ${arch}.\n` +
-        `The Windows/Linux Go server is in preview — check https://local-mcp.com for updates.`
+        `Failed to install LMCP ${platformVersion} (${arch}) from ${url}:\n  ${err.message}`
       )
     }
 
@@ -360,9 +399,12 @@ async function ensureTeamsProxy() {
  * @returns {Promise<string|null>} Ruta al .app instalado, o null si falla
  */
 async function ensureTray() {
-  // Windows: download lmcp-tray.exe
-  if (process.platform === 'win32') {
-    return _ensureTrayWindows()
+  // Windows/Linux: the tray + background daemon are installed by the native
+  // installer (LMCP-Setup.exe on Windows; the systemd unit on Linux), NOT by npm.
+  // The npm package is a stdio proxy for MCP hosts, so there is no tray to fetch
+  // here — no-op instead of downloading a lmcp-tray binary.
+  if (process.platform !== 'darwin') {
+    return null
   }
 
   // Respect explicit uninstall — don't resurrect tray if user ran `uninstall`.

package/index.js

@@ -51,10 +51,12 @@ function clearUninstallSentinels() {
   for (const p of uninstallSentinelPaths()) { try { fs.unlinkSync(p) } catch {} }
 }
 
-// Platform support: macOS only (Windows/Linux on waitlist at local-mcp.com)
-const SUPPORTED_PLATFORMS = ['darwin']
+// Platform support: macOS (Swift tray + embedded server), Windows & Linux
+// (go-server standalone binary downloaded from R2). Re-enabled for the
+// Windows/Linux public re-launch — the waitlist gate is retired.
+const SUPPORTED_PLATFORMS = ['darwin', 'win32', 'linux']
 if (!SUPPORTED_PLATFORMS.includes(process.platform)) {
-  console.error(`LMCP is currently macOS-only. Join the Windows/Linux waitlist at https://local-mcp.com`)
+  console.error(`LMCP supports macOS, Windows and Linux. Your platform (${process.platform}) is not supported yet — see https://local-mcp.com`)
   process.exit(1)
 }
 
@@ -222,7 +224,12 @@ async function main() {
 
   // ── Modo default: stdio MCP server ──────────────────────────────────────────
   const { CACHE_DIR } = require('./download')
-  const binName = process.platform === 'win32' ? 'local-mcp-server.exe' : 'local-mcp-server'
+  // macOS ships the Swift `local-mcp-server` (standalone fallback to the embedded
+  // tray server); Windows/Linux ship the go-server `lmcp-server` binary that
+  // download.js writes to CACHE_DIR. Keep this name in sync with download.js.
+  const binName = process.platform === 'darwin'
+    ? 'local-mcp-server'
+    : (process.platform === 'win32' ? 'lmcp-server.exe' : 'lmcp-server')
   const stableBin = path.join(CACHE_DIR, binName)
   const versionFile = path.join(CACHE_DIR, '.server-version')
   const pkg = require('./package.json')
@@ -365,7 +372,12 @@ async function main() {
   // because stale npx cache had old pkg.version and triggered the slow path unnecessarily.
   try {
     const stat = fs.lstatSync(stableBin)
-    if (stat.isFile() && (stat.mode & 0o111)) {
+    // Windows .exe files carry no Unix exec bit — Node's fs reports mode 0o666 —
+    // so the `& 0o111` gate is always false there, which forced EVERY spawn onto
+    // the slow path (a /runtime/latest network round-trip before launch, and a
+    // hard failure when offline despite a valid cached binary). Only require the
+    // exec bit off-Windows, where it's meaningful.
+    if (stat.isFile() && (process.platform === 'win32' || (stat.mode & 0o111))) {
       const cachedVersion = fs.existsSync(versionFile)
         ? fs.readFileSync(versionFile, 'utf8').trim()
         : ''

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-mcp",
-  "version": "3.0.370",
+  "version": "3.0.372",
   "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.",
   "main": "index.js",
   "bin": {
@@ -20,7 +20,9 @@
     "node": ">=18"
   },
   "os": [
-    "darwin"
+    "darwin",
+    "linux",
+    "win32"
   ],
   "keywords": [
     "mcp",

package/postinstall.js

@@ -9,11 +9,6 @@ if (!process.env.npm_config_global || process.env.CI || process.env.SKIP_SETUP)
   process.exit(0)
 }
 
-// Solo macOS
-if (process.platform !== 'darwin') {
-  process.exit(0)
-}
-
 const { runSetup } = require('./setup')
 
 runSetup({ all: true }).catch(err => {

package/setup.js

@@ -331,23 +331,10 @@ function injectMcpConfig(client, command = NPX_COMMAND, args = NPX_ARGS) {
 // ── Main ──────────────────────────────────────────────────────────────────────
 
 async function runSetup(opts = {}) {
-  // macOS only. `npx local-mcp setup` on Windows/Linux used to silently download +
-  // configure the (still-present) Go server, bypassing the Mac-only waitlist that the
-  // landing page and cloud connector enforce. Gate it here so new non-mac installs get
-  // the waitlist message instead of a working-but-unsupported install. (The legacy
-  // Windows R2 binaries stay so the existing fleet keeps auto-updating.)
-  if (process.platform !== 'darwin') {
-    const osName = process.platform === 'win32' ? 'Windows' : process.platform === 'linux' ? 'Linux' : process.platform
-    console.log(`\n  LMCP is macOS-only right now — ${osName} isn't supported yet.`)
-    console.log('  Join the waitlist to be notified when it ships:  https://local-mcp.com\n')
-    try {  // best-effort: record the gated attempt so we can size non-mac demand
-      const https = require('https')
-      const req = https.request({ hostname: BACKEND_HOST, path: '/install/started/npm-gated-' + process.platform, method: 'POST', timeout: 2500 })
-      req.on('error', () => {}); req.end()
-    } catch {}
-    return
-  }
-
+  // Cross-platform: macOS configures the Swift tray + embedded server; Windows/Linux
+  // download the go-server standalone binary (download.js) and write the MCP client
+  // config (the config writer already handles Windows paths). The Mac-only waitlist
+  // gate was retired for the Windows/Linux public re-launch.
   const forceAll = opts.all || process.argv.includes('--all')
   const refArg = process.argv.find(a => a.startsWith('--ref='))
   if (refArg) process.env.LMCP_REF = refArg.split('=')[1]
@@ -584,7 +571,7 @@ async function runSetup(opts = {}) {
   if (configured.length > 0) {
     if (healthOk) {
       console.log(`✅ LMCP configured for: ${configured.join(', ')}\n`)
-      console.log('  ✓ Server binary verified — 100 tools ready\n')
+      console.log('  ✓ Server binary verified — 215+ tools ready\n')
     } else {
       console.log(`⚠  LMCP configured for: ${configured.join(', ')}`)
       console.log('  Server binary could not be verified — it may still work after restart.\n')