local-mcp 3.0.70 → 3.0.72

package/README.md

@@ -16,6 +16,8 @@ curl -fsSL https://local-mcp.com/install?ref=npm | bash
 
 Auto-detects and configures: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, and Zed. Restart your AI client once.
 
+> **Cursor users:** LMCP tools only appear in **Agent mode**. Open a new Composer window (⌘I) and make sure the mode selector shows **Agent** (not Chat or Edit). Without Agent mode, the tools are installed but invisible.
+
 **Or via npx:**
 
 ```bash
@@ -114,6 +116,10 @@ System: `diagnose` `run_diagnostics` `version_info` `get_config` `update_local_m
 | VS Code | `~/.vscode/mcp.json` |
 | Zed | `~/.config/zed/settings.json` |
 
+### Cursor users
+
+After install, switch to **Agent mode** in the Cursor chat panel — MCP tools only appear in Agent mode, not in Ask or Edit mode. Click the mode selector at the bottom of the chat input.
+
 ## Commands
 
 ```bash

package/download.js

@@ -310,4 +310,49 @@ function _writeTrayLaunchAgent(trayApp) {
   } catch { /* no crítico */ }
 }
 
-module.exports = { ensureBinary, ensureRuntime, ensureTray, ensureTeamsProxy, CACHE_DIR, TRAY_DIR }
+/**
+ * Descarga el co-proceso m365-proxy si no está instalado o es una versión diferente.
+ * El binary se instala en ~/.local/share/local-mcp/bin/m365-proxy
+ * @returns {Promise<string|null>} Ruta al binary, o null si falla
+ */
+async function ensureM365Proxy() {
+  const info = await getLatestBinary()
+  const version = info.version
+  const arch = process.arch === 'arm64' ? 'darwin-arm64' : 'darwin-x64'
+  const binPath = path.join(CACHE_DIR, 'm365-proxy')
+  const verFile = path.join(CACHE_DIR, '.m365-proxy-version')
+
+  // Ya instalado y actualizado
+  if (fs.existsSync(binPath) && fs.existsSync(verFile)) {
+    if (fs.readFileSync(verFile, 'utf8').trim() === version) return binPath
+  }
+
+  const url = `https://download.local-mcp.com/m365-proxy-${version}-${arch}.tar.gz`
+  process.stderr.write(`\nDescargando m365-proxy v${version}...\n`)
+
+  fs.mkdirSync(CACHE_DIR, { recursive: true })
+  const tarPath = path.join(CACHE_DIR, `m365-proxy-${version}.tar.gz`)
+
+  try {
+    await downloadFile(url, tarPath)
+    const stat = fs.statSync(tarPath)
+    if (stat.size < 1000) { fs.unlinkSync(tarPath); throw new Error(`Descarga incompleta (${stat.size} bytes)`) }
+
+    execFileSync('tar', ['-xzf', tarPath, '-C', CACHE_DIR], { stdio: 'pipe' })
+    fs.unlinkSync(tarPath)
+
+    if (!fs.existsSync(binPath)) throw new Error('m365-proxy no encontrado tras extraer')
+    fs.chmodSync(binPath, 0o755)
+    try { execFileSync('codesign', ['--force', '--sign', '-', '--identifier', 'com.local-mcp.m365-proxy', binPath], { stdio: 'pipe' }) } catch { /* no crítico */ }
+
+    fs.writeFileSync(verFile, version, 'utf8')
+    process.stderr.write(`  m365-proxy instalado en ${binPath}\n`)
+    return binPath
+  } catch (err) {
+    try { if (fs.existsSync(tarPath)) fs.unlinkSync(tarPath) } catch {}
+    process.stderr.write(`  (m365-proxy no disponible: ${err.message})\n`)
+    return null
+  }
+}
+
+module.exports = { ensureBinary, ensureRuntime, ensureTray, ensureTeamsProxy, ensureM365Proxy, CACHE_DIR, TRAY_DIR }

package/index.js

@@ -122,9 +122,10 @@ async function main() {
         : ''
       if (cachedVersion === pkg.version) {
         // Version matches — use fast path
-        const { ensureTray, ensureTeamsProxy } = require('./download')
+        const { ensureTray, ensureTeamsProxy, ensureM365Proxy } = require('./download')
         ensureTray().catch(() => {})
         ensureTeamsProxy().catch(() => {})
+        ensureM365Proxy().catch(() => {})
         const child = spawn(stableBin, [], { stdio: 'inherit', env: process.env })
         child.on('error', () => process.exit(1))
         child.on('exit', (code) => process.exit(code ?? 0))
@@ -143,11 +144,12 @@ async function main() {
   }
 
   // Slow path: download/repair binary
-  const { ensureRuntime, ensureTray, ensureTeamsProxy } = require('./download')
+  const { ensureRuntime, ensureTray, ensureTeamsProxy, ensureM365Proxy } = require('./download')
 
-  // Actualizar tray + teams-proxy en background
+  // Actualizar tray + teams-proxy + m365-proxy en background
   ensureTray().catch(() => {})
   ensureTeamsProxy().catch(() => {})
+  ensureM365Proxy().catch(() => {})
 
   let runtime
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-mcp",
-  "version": "3.0.70",
+  "version": "3.0.72",
   "description": "LMCP — connect Claude Desktop, Cursor, Windsurf to Mail, Calendar, Contacts, Teams, OneDrive on macOS. Privacy-first: all data stays on your Mac.",
   "main": "index.js",
   "bin": {

package/setup.js

@@ -151,6 +151,18 @@ async function runSetup(opts = {}) {
       fs.copyFileSync(binPath, tmpPath)
       fs.chmodSync(tmpPath, 0o755)
       try { execFileSync('codesign', ['--force', '--sign', '-', '--identifier', 'com.local-mcp.server', tmpPath], { stdio: 'pipe' }) } catch {}
+      // curl route-3 installs the binary one level deeper:
+      //   ~/.local/share/local-mcp/bin/local-mcp-server/local-mcp-server
+      // leaving stablePath itself as a DIRECTORY. fs.renameSync throws EISDIR
+      // silently, so the npm stable binary is never written and the old curl
+      // server stays running forever (LMC-158).
+      try {
+        const st = fs.statSync(stablePath)
+        if (st.isDirectory()) {
+          process.stderr.write('  Migrating from curl install: removing old versioned directory at stable path\n')
+          fs.rmSync(stablePath, { recursive: true, force: true })
+        }
+      } catch { /* stablePath doesn't exist — nothing to do */ }
       fs.renameSync(tmpPath, stablePath)
       // Write version file so fast path knows when to update
       const pkg = require('./package.json')
@@ -170,13 +182,32 @@ async function runSetup(opts = {}) {
   const detected = CLIENTS.filter(c => c.detect())
 
   if (detected.length === 0) {
-    console.log('No AI clients detected.')
-    console.log('Install Claude Desktop, Cursor, Windsurf, or VS Code and run this command again.\n')
-    console.log('Or add this manually to your AI client config:')
-    const manualEntry = stableArgs !== undefined
+    const entry = stableArgs !== undefined
       ? { command: stableCommand, args: stableArgs }
       : { command: stableCommand }
-    console.log(JSON.stringify({ mcpServers: { 'local-mcp': manualEntry } }, null, 2))
+    const snippet = JSON.stringify({ mcpServers: { 'local-mcp': entry } }, null, 2)
+      .split('\n').map(l => '     ' + l).join('\n')
+
+    console.log('╔══════════════════════════════════════════════════════════╗')
+    console.log('║  LMCP installed — no AI client detected yet             ║')
+    console.log('╚══════════════════════════════════════════════════════════╝\n')
+    console.log('  To get started, add LMCP to your AI client config:\n')
+    console.log('  ── Claude Desktop ────────────────────────────────────────')
+    console.log('  File: ~/Library/Application Support/Claude/claude_desktop_config.json\n')
+    console.log(snippet)
+    console.log('\n  ── Cursor ────────────────────────────────────────────────')
+    console.log('  File: ~/.cursor/mcp.json\n')
+    console.log(snippet)
+    console.log('\n  ── VS Code (Cline / GitHub Copilot) ──────────────────────')
+    console.log('  File: ~/.vscode/mcp.json\n')
+    console.log(snippet)
+    console.log('\n  Then restart your AI client and try:')
+    console.log('    "Summarize my unread emails"\n')
+    console.log('  ── Already installed an AI client? ───────────────────────')
+    console.log('  Run this to auto-configure it:')
+    console.log('    npx local-mcp setup\n')
+    console.log('  Full setup guide: https://local-mcp.com/setup')
+    console.log('─────────────────────────────────────────────────────────────\n')
     return
   }
 
@@ -215,27 +246,51 @@ async function runSetup(opts = {}) {
   // Health check — verify binary works before showing success
   const healthOk = _runHealthCheck()
 
+  const hasCursor = configured.includes('Cursor')
+
   console.log('\n──────────────────────────────────────')
   if (configured.length > 0) {
     if (healthOk) {
       console.log(`✅ LMCP configured for: ${configured.join(', ')}\n`)
-      console.log('  ✓ Server binary verified — 82 tools ready\n')
+      console.log('  ✓ Server binary verified — 95 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')
     }
-    console.log('┌─────────────────────────────────────────────────────┐')
-    console.log('│  NEXT STEP — This is important:                     │')
-    console.log('│                                                     │')
-    console.log(`│  Quit and reopen ${configured[0].padEnd(35)}│`)
-    console.log('│  LMCP will appear automatically.               │')
-    console.log('│                                                     │')
-    console.log('│  Then try: "Summarize my unread emails"             │')
-    console.log('└─────────────────────────────────────────────────────┘\n')
+
+    if (hasCursor) {
+      console.log('┌─────────────────────────────────────────────────────┐')
+      console.log('│  CURSOR — 3 steps to activate:                      │')
+      console.log('│                                                     │')
+      console.log('│  1. Quit Cursor completely (Cmd+Q)                  │')
+      console.log('│  2. Reopen Cursor                                   │')
+      console.log('│  3. Cursor Settings (⚙) → MCP → find "local-mcp"   │')
+      console.log('│     → toggle it ON if not already enabled           │')
+      console.log('│                                                     │')
+      console.log('│  Then ask: "Summarize my unread emails"             │')
+      console.log('│                                                     │')
+      console.log('│  Guide: local-mcp.com/guides/cursor-mcp-setup       │')
+      console.log('└─────────────────────────────────────────────────────┘\n')
+    } else {
+      const primaryClient = configured[0]
+      console.log('┌─────────────────────────────────────────────────────┐')
+      console.log('│  NEXT STEP — This is important:                     │')
+      console.log('│                                                     │')
+      console.log(`│  Quit and reopen ${primaryClient.padEnd(35)}│`)
+      console.log('│  LMCP will appear automatically.               │')
+      console.log('│                                                     │')
+      console.log('│  Then try: "Summarize my unread emails"             │')
+      console.log('└─────────────────────────────────────────────────────┘\n')
+    }
   }
   if (failed.length > 0) {
     console.log(`⚠  Could not configure: ${failed.join(', ')} — check permissions and try again.\n`)
   }
+  console.log('  Setup guide & troubleshooting: https://local-mcp.com/setup\n')
+
+  // Migrate legacy curl LaunchAgent before launching tray — must run first
+  // so the tray's DaemonSupervisor doesn't race against the old server.
+  _migrateCurlLaunchAgent()
 
   // Instalar y lanzar el tray (menu bar app) — arm64 only, non-fatal
   await _installTray()
@@ -362,6 +417,28 @@ async function _promptEmail() {
   })
 }
 
+/**
+ * Detects and removes the legacy com.local-mcp.server LaunchAgent left behind
+ * by older curl installs. In the current architecture the tray app's
+ * DaemonSupervisor manages the server process — the standalone LaunchAgent is
+ * no longer needed and causes the old binary to keep running after an npm
+ * migration (LMC-158).
+ */
+function _migrateCurlLaunchAgent() {
+  const plistPath = path.join(HOME, 'Library', 'LaunchAgents', 'com.local-mcp.server.plist')
+  if (!fs.existsSync(plistPath)) return
+  try {
+    const content = fs.readFileSync(plistPath, 'utf8')
+    // Only act on plists that reference an LMCP server binary
+    if (!content.includes('local-mcp-server') && !content.includes('Local MCP')) return
+    process.stderr.write('\n  Migrating legacy server LaunchAgent to tray supervision...\n')
+    // launchctl unload kills the running process AND prevents it from restarting
+    try { execFileSync('launchctl', ['unload', plistPath], { stdio: 'pipe' }) } catch { /* may already be unloaded */ }
+    try { fs.unlinkSync(plistPath) } catch { /* non-fatal */ }
+    process.stderr.write('  ✓ Legacy server LaunchAgent removed — server will be restarted by tray\n\n')
+  } catch { /* non-fatal — don't block install on unexpected plist content */ }
+}
+
 function _pingInstall(clients, method, email = '') {
   try {
     const https = require('https')