@softtechai/quickmcp 1.0.11 → 1.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softtechai/quickmcp",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "An application to generate MCP servers from various data sources and test them",
   "main": "dist/index.js",
   "bin": {

package/quickmcp-direct-stdio.js

@@ -3,6 +3,7 @@
 const path = require('path');
 const fs = require('fs');
 const os = require('os');
+const net = require('net');
 
 // Use the current working directory provided by the caller.
 // Do not change directories; keep paths relative to this script.
@@ -58,11 +59,86 @@ if (process.env.QUICKMCP_ENABLE_WEB === '1') {
     const uploadsDir = path.join(runDir, 'uploads');
     try { fs.mkdirSync(uploadsDir, { recursive: true }); } catch {}
     if (!process.env.QUICKMCP_UPLOAD_DIR) process.env.QUICKMCP_UPLOAD_DIR = uploadsDir;
-    // This require starts the Express app and integrated MCP sidecar
+    
+    // Acquire a simple lock so only one process owns the UI (port 3000)
+    const lockPath = path.join(runDir, 'ui-3000.lock');
+    let hasLock = false;
+    try {
+      const fd = fs.openSync(lockPath, 'wx');
+      fs.closeSync(fd);
+      hasLock = true;
+      const cleanup = () => { try { fs.unlinkSync(lockPath); } catch {} };
+      process.once('exit', cleanup);
+      process.once('SIGINT', () => { cleanup(); process.exit(0); });
+      process.once('SIGTERM', () => { cleanup(); process.exit(0); });
+    } catch (e) {
+      if (e && e.code !== 'EEXIST') {
+        console.error('[QuickMCP] UI lock error (continuing without UI):', e.message || e);
+      }
+      // Another process holds the UI lock; skip starting UI in this process
+    }
+
+    if (!hasLock) {
+      return; // do not try to start UI
+    }
+
+    // Only start Web UI if preferred port is actually free.
+    const preferredPort = parseInt(process.env.PORT || '3000', 10);
+    const probe = net.createServer();
+    probe.once('error', (err) => {
+      if (err && (err.code === 'EADDRINUSE' || err.code === 'EACCES')) {
+        // Port is busy or not permitted; skip starting Web UI to avoid crashing Claude session
+        try { fs.unlinkSync(lockPath); } catch {}
+        return;
+      }
+      // For other errors, still try starting server; better to attempt than silently skip for unknown cases
+      safeStartWebServer();
+    });
+    probe.once('listening', () => {
+      probe.close(() => {
+        safeStartWebServer();
+      });
+    });
+    try {
+      // Probe on IPv6 unspecified to mirror Express default, falling back to IPv4 if needed
+      probe.listen(preferredPort, '::');
+    } catch (_e) {
+      // If probing throws synchronously (rare), just skip UI
+    }
+  } catch (e) {
+    console.error('[QuickMCP] Failed to start Web UI:', e && e.message);
+  }
+}
+
+// Start the web server but swallow a race-condition EADDRINUSE from Express listen
+function safeStartWebServer() {
+  let handled = false;
+  const handler = (err) => {
+    if (!handled && err && err.code === 'EADDRINUSE' && err.syscall === 'listen') {
+      handled = true;
+      // Swallow this once so the STDIO server keeps running; another instance already owns :3000
+      process.removeListener('uncaughtException', handler);
+      return;
+    }
+    // Not our case; restore default behavior
+    process.removeListener('uncaughtException', handler);
+    throw err;
+  };
+  // Install one-time handler to catch immediate async throw from Express
+  process.prependOnceListener('uncaughtException', handler);
+  try {
     require('./dist/web/server.js');
   } catch (e) {
+    // Synchronous load error
+    process.removeListener('uncaughtException', handler);
     console.error('[QuickMCP] Failed to start Web UI:', e && e.message);
   }
+  // Remove handler on next tick if nothing happened, to avoid swallowing unrelated errors later
+  setImmediate(() => {
+    if (!handled) {
+      process.removeListener('uncaughtException', handler);
+    }
+  });
 }
 
 // Diagnostics: print environment and mssql details to help debug Claude Desktop