squeezr-ai 1.17.5 → 1.17.7

package/README.md

@@ -174,7 +174,7 @@ Squeezr uses cheap/free models for AI compression (the deterministic layer is pu
 ## CLI commands
 
 ```bash
-squeezr setup      # configure env vars, auto-start, CA trust
+squeezr setup      # configure env vars, auto-start, CA trust, install MCP server
 squeezr start      # start the proxy (auto-restarts if version mismatch after update)
 squeezr update     # kill old processes, install latest from npm, restart
 squeezr stop       # stop the proxy
@@ -184,10 +184,28 @@ squeezr config     # print current config
 squeezr ports      # change HTTP and MITM proxy ports
 squeezr gain       # estimate token savings for a directory
 squeezr discover   # detect which AI CLIs are installed
+squeezr mcp install    # register MCP server in Claude Code, Cursor, Windsurf, Cline
+squeezr mcp uninstall  # remove MCP server registration
 squeezr uninstall  # remove Squeezr completely (env vars, CA, auto-start, logs)
 squeezr version    # print version
 ```
 
+## MCP server
+
+Squeezr ships with a built-in MCP server (`squeezr-mcp`) that gives any MCP-capable AI CLI real-time awareness of Squeezr's state and control over it.
+
+**Installed automatically** by `squeezr setup` into Claude Code, Cursor, Windsurf, and Cline.
+
+Available MCP tools:
+
+| Tool | Description |
+|---|---|
+| `squeezr_status` | Is proxy running? Version, port, uptime, mode |
+| `squeezr_stats` | Token savings, compression %, cost saved, per-tool breakdown |
+| `squeezr_set_mode` | Change compression mode instantly (soft / normal / aggressive / critical) |
+| `squeezr_config` | Current thresholds, keepRecent, cache sizes |
+| `squeezr_habits` | Detect wasteful patterns this session (duplicate reads, high Bash count, cache efficiency) |
+
 ## Requirements
 
 - Node.js 18+ (compatible with Node.js 24)

package/bin/squeezr.js

@@ -199,10 +199,10 @@ Usage:
   squeezr discover         Show pattern coverage report (proxy must be running)
   squeezr status           Check if proxy is running
   squeezr config           Print config file path and current settings
+  squeezr mcp install      Register Squeezr MCP server in Claude Code, Cursor, Windsurf & Cline
+  squeezr mcp uninstall    Remove Squeezr MCP registration
   squeezr ports            Change HTTP and MITM proxy ports
   squeezr tunnel           Expose proxy via Cloudflare Tunnel for Cursor IDE
-  squeezr cursor           Start Cursor subscription MITM proxy (no BYOK needed)
-  squeezr cursor stop      Stop Cursor proxy and clean up system proxy settings
   squeezr update           Kill old processes, install latest from npm, restart
   squeezr uninstall        Remove Squeezr completely (env vars, CA, auto-start, logs)
   squeezr version          Print version
@@ -393,6 +393,100 @@ function showConfig() {
   }
 }
 
+
+// ── squeezr mcp ───────────────────────────────────────────────────────────────
+
+async function mcpInstall() {
+  const mcpServerPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'dist', 'mcp.js')
+  const entry = {
+    type: 'stdio',
+    command: 'node',
+    args: [mcpServerPath],
+  }
+
+  const targets = [
+    {
+      name: 'Claude Code',
+      file: path.join(os.homedir(), '.claude.json'),
+      key: 'mcpServers',
+    },
+    {
+      name: 'Cursor',
+      file: path.join(os.homedir(), '.cursor', 'mcp.json'),
+      key: 'mcpServers',
+    },
+    {
+      name: 'Windsurf',
+      file: path.join(os.homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+      key: 'mcpServers',
+    },
+    {
+      name: 'Cline / Roo-Cline',
+      file: path.join(os.homedir(), '.vscode', 'extensions', 'mcp_settings.json'),
+      key: 'mcpServers',
+    },
+  ]
+
+  let installed = 0
+
+  for (const target of targets) {
+    try {
+      // Only install into configs that already exist (user has that tool)
+      if (!fs.existsSync(target.file) && target.name !== 'Claude Code') continue
+
+      let cfg = {}
+      if (fs.existsSync(target.file)) {
+        try { cfg = JSON.parse(fs.readFileSync(target.file, 'utf-8')) } catch { cfg = {} }
+      }
+      cfg[target.key] = cfg[target.key] || {}
+      cfg[target.key].squeezr = entry
+
+      const dir = path.dirname(target.file)
+      if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true })
+      fs.writeFileSync(target.file, JSON.stringify(cfg, null, 2))
+      console.log()
+      console.log('  ok ' + target.name + ': ' + target.file)
+    } catch (e) {
+      console.warn()
+      console.warn('  warn ' + target.name + ': ' + (e.message || e))
+  }
+
+  console.log()
+  console.log('MCP server registered in ' + installed + ' client(s).')
+  console.log('Server binary: ' + mcpServerPath)
+  console.log('')
+  console.log('Available tools in Claude/Codex/Cursor:')
+  console.log('  squeezr_status   — Check if Squeezr is running')
+  console.log('  squeezr_stats    — Real-time token savings')
+  console.log('  squeezr_set_mode — Change compression aggressiveness')
+  console.log('  squeezr_config   — Current configuration')
+  console.log('  squeezr_habits   — Wasteful pattern report')
+}
+
+async function mcpUninstall() {
+  const files = [
+    path.join(os.homedir(), '.claude.json'),
+    path.join(os.homedir(), '.cursor', 'mcp.json'),
+    path.join(os.homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+    path.join(os.homedir(), '.vscode', 'extensions', 'mcp_settings.json'),
+  ]
+  let removed = 0
+  for (const file of files) {
+    if (!fs.existsSync(file)) continue
+    try {
+      const cfg = JSON.parse(fs.readFileSync(file, 'utf-8'))
+      if (cfg.mcpServers?.squeezr) {
+        delete cfg.mcpServers.squeezr
+        fs.writeFileSync(file, JSON.stringify(cfg, null, 2))
+        console.log()
+        removed++
+      }
+    } catch { /* ignore */ }
+  }
+  if (removed === 0) console.log('Squeezr MCP not found in any config.')
+  else console.log()
+}
+
 // ── squeezr ports ─────────────────────────────────────────────────────────────
 
 async function configurePorts() {
@@ -1256,162 +1350,6 @@ async function startTunnel() {
   process.on('SIGTERM', () => { child.kill(); process.exit(0) })
 }
 
-// ── squeezr cursor ───────────────────────────────────────────────────────────
-
-async function startCursorProxy() {
-  const port = getPort()
-  const mitmPort = getMitmPort(port)
-
-  // Verify main proxy is running first
-  const running = await new Promise(resolve => {
-    const req = http.get(`http://localhost:${port}/squeezr/health`, res => {
-      resolve(res.statusCode === 200)
-    })
-    req.on('error', () => resolve(false))
-    req.setTimeout(2000, () => { req.destroy(); resolve(false) })
-  })
-
-  if (!running) {
-    console.error(`Squeezr proxy is not running on port ${port}.`)
-    console.error('Start it first: squeezr start')
-    process.exit(1)
-  }
-
-  // Verify CA exists
-  const caDir = path.join(os.homedir(), '.squeezr', 'mitm-ca')
-  const caCertPath = path.join(caDir, 'ca.crt')
-  if (!fs.existsSync(caCertPath)) {
-    console.error('MITM CA certificate not found. Run `squeezr setup` first.')
-    process.exit(1)
-  }
-
-  console.log('Starting Cursor MITM proxy...')
-
-  const distPath = path.join(ROOT, 'dist', 'cursorMitm.js')
-  if (!fs.existsSync(distPath)) {
-    console.error(`Error: ${distPath} not found. Run 'npm run build' first.`)
-    process.exit(1)
-  }
-
-  const distUrl = process.platform === 'win32' ? 'file:///' + distPath.replace(/\\/g, '/') : distPath
-  const { startCursorMitm, getCursorMitmPort, getCursorStats } = await import(distUrl)
-
-  try {
-    await startCursorMitm()
-  } catch (err) {
-    console.error('Failed to start Cursor proxy:', err.message)
-    process.exit(1)
-  }
-
-  const actualPort = getCursorMitmPort()
-  const proxyConfigured = configureSystemProxy(actualPort)
-
-  console.log('')
-  console.log('╔══════════════════════════════════════════════════════════════════╗')
-  console.log(`║  Cursor MITM proxy active on port ${actualPort}                        ║`)
-  console.log('╠══════════════════════════════════════════════════════════════════╣')
-  console.log('║                                                                  ║')
-  console.log('║  Intercepting: api2.cursor.sh (chat, agent, composer)           ║')
-  console.log('║  Compressing:  conversation context via cursor-small            ║')
-  console.log('║  Everything else: transparent pass-through                       ║')
-  console.log('║                                                                  ║')
-  if (proxyConfigured) {
-    console.log('║  System proxy configured automatically.                         ║')
-    console.log('║  Cursor will route through Squeezr on next request.             ║')
-  } else {
-    console.log('║  ⚠ Could not set system proxy automatically.                   ║')
-    console.log('║  Set it manually:                                               ║')
-    if (process.platform === 'win32') {
-      console.log(`║    Settings > Network > Proxy > Manual: 127.0.0.1:${actualPort}     ║`)
-    } else if (process.platform === 'darwin') {
-      console.log(`║    networksetup -setsecurewebproxy Wi-Fi 127.0.0.1 ${actualPort}     ║`)
-    } else {
-      console.log(`║    export HTTPS_PROXY=http://127.0.0.1:${actualPort}                  ║`)
-    }
-  }
-  console.log('║                                                                  ║')
-  console.log('║  Press Ctrl+C to stop and clean up proxy settings               ║')
-  console.log('╚══════════════════════════════════════════════════════════════════╝')
-  console.log('')
-
-  const statsInterval = setInterval(() => {
-    const s = getCursorStats()
-    if (s.requests > 0) {
-      console.log(`[squeezr/cursor] Stats: ${s.requests} requests, ${s.compressed} compressed, -${s.charsSaved.toLocaleString()} chars saved`)
-    }
-  }, 30_000)
-
-  const cleanup = () => {
-    clearInterval(statsInterval)
-    console.log('\nStopping Cursor proxy...')
-    cleanSystemProxy()
-    const s = getCursorStats()
-    console.log(`Session: ${s.requests} requests, ${s.compressed} compressed, -${s.charsSaved.toLocaleString()} chars saved`)
-    process.exit(0)
-  }
-
-  process.on('SIGINT', cleanup)
-  process.on('SIGTERM', cleanup)
-}
-
-function configureSystemProxy(port) {
-  try {
-    if (process.platform === 'win32') {
-      execSync(`reg add "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings" /v ProxyEnable /t REG_DWORD /d 1 /f`, { stdio: 'pipe' })
-      execSync(`reg add "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings" /v ProxyServer /t REG_SZ /d "127.0.0.1:${port}" /f`, { stdio: 'pipe' })
-      execSync(`reg add "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings" /v ProxyOverride /t REG_SZ /d "<local>;localhost;127.0.0.1" /f`, { stdio: 'pipe' })
-      return true
-    } else if (process.platform === 'darwin') {
-      try {
-        const services = execSync('networksetup -listallnetworkservices', { encoding: 'utf-8' })
-          .split('\n')
-          .filter(s => s.trim() && !s.startsWith('*') && !s.startsWith('An asterisk'))
-        for (const svc of services) {
-          try {
-            execSync(`networksetup -setsecurewebproxy "${svc.trim()}" 127.0.0.1 ${port}`, { stdio: 'pipe' })
-          } catch {}
-        }
-        return true
-      } catch { return false }
-    } else {
-      try {
-        execSync(`gsettings set org.gnome.system.proxy mode 'manual'`, { stdio: 'pipe' })
-        execSync(`gsettings set org.gnome.system.proxy.https host '127.0.0.1'`, { stdio: 'pipe' })
-        execSync(`gsettings set org.gnome.system.proxy.https port ${port}`, { stdio: 'pipe' })
-        return true
-      } catch { return false }
-    }
-  } catch {
-    return false
-  }
-}
-
-function cleanSystemProxy() {
-  try {
-    if (process.platform === 'win32') {
-      execSync(`reg add "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings" /v ProxyEnable /t REG_DWORD /d 0 /f`, { stdio: 'pipe' })
-    } else if (process.platform === 'darwin') {
-      try {
-        const services = execSync('networksetup -listallnetworkservices', { encoding: 'utf-8' })
-          .split('\n')
-          .filter(s => s.trim() && !s.startsWith('*') && !s.startsWith('An asterisk'))
-        for (const svc of services) {
-          try {
-            execSync(`networksetup -setsecurewebproxystate "${svc.trim()}" off`, { stdio: 'pipe' })
-          } catch {}
-        }
-      } catch {}
-    } else {
-      try {
-        execSync(`gsettings set org.gnome.system.proxy mode 'none'`, { stdio: 'pipe' })
-      } catch {}
-    }
-    console.log('System proxy settings cleaned up.')
-  } catch {
-    console.warn('Could not clean system proxy settings. You may need to disable manually.')
-  }
-}
-
 // ── CLI router ────────────────────────────────────────────────────────────────
 
 switch (command) {
@@ -1529,14 +1467,6 @@ switch (command) {
     await startTunnel()
     break
 
-  case 'cursor':
-    if (args[1] === 'stop') {
-      cleanSystemProxy()
-    } else {
-      await startCursorProxy()
-    }
-    break
-
   case 'uninstall':
     await uninstall()
     break
@@ -1544,6 +1474,12 @@ switch (command) {
     showConfig()
     break
 
+  case 'mcp': {
+    const subCmd = args[0] ?? 'install'
+    if (subCmd === 'uninstall') await mcpUninstall()
+    else await mcpInstall()
+    break
+  }
   case 'version':
   case '--version':
   case '-v':

package/dist/mcp.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Squeezr MCP Server
+ *
+ * Gives any MCP-compatible AI CLI (Claude Code, Cursor, Windsurf, Cline…)
+ * real-time awareness of Squeezr's state and control over it.
+ *
+ * Transport: stdio (universal — works with all MCP clients)
+ * Queries the Squeezr proxy via HTTP on localhost.
+ *
+ * Tools exposed:
+ *   squeezr_status   — Is proxy running? Port, version, uptime
+ *   squeezr_stats    — Token savings, compression %, by-tool breakdown
+ *   squeezr_set_mode — Change compression aggressiveness instantly
+ *   squeezr_config   — Current thresholds and settings
+ *   squeezr_habits   — Detected wasteful patterns this session
+ */
+export {};