@softtechai/quickmcp 1.1.0 → 1.1.2

package/README.md

@@ -479,7 +479,7 @@ QuickMCP, NPM üzerinden çalıştırıldığında artık varsayılan olarak web
 ### Hızlı başlatma
 
 ```bash
-npx -y @softtech/quickmcp
+npx -y @softtechai/quickmcp
 # UI -> http://localhost:3000
 # Integrated MCP sidecar -> :3001
 ```
@@ -493,7 +493,7 @@ npx -y @softtech/quickmcp
 Örnek:
 
 ```bash
-npx -y @softtech/quickmcp --port=4000 --data-dir=./data
+npx -y @softtechai/quickmcp --port=4000 --data-dir=./data
 ```
 
 ### Ortam değişkenleri
@@ -506,7 +506,7 @@ npx -y @softtech/quickmcp --port=4000 --data-dir=./data
 Örnek:
 
 ```bash
-PORT=4000 QUICKMCP_DATA_DIR=./data npx -y @softtech/quickmcp
+PORT=4000 QUICKMCP_DATA_DIR=./data npx -y @softtechai/quickmcp
 ```
 
 > Not: Web UI, stdio tabanlı MCP sunucusunun yanında yan servis olarak çalışır; Claude Desktop entegrasyonu ile çakışmaz.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softtechai/quickmcp",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "An application to generate MCP servers from various data sources and test them",
   "main": "dist/index.js",
   "bin": {
@@ -40,6 +40,7 @@
     "better-sqlite3": "^12.4.1",
     "cors": "^2.8.5",
     "csv-parser": "^3.0.0",
+    "dotenv": "^16.4.5",
     "exceljs": "^4.4.0",
     "express": "^4.18.0",
     "imapflow": "^1.2.6",
@@ -63,7 +64,6 @@
     "@types/ws": "^8.5.0",
     "@typescript-eslint/eslint-plugin": "^6.0.0",
     "@typescript-eslint/parser": "^6.0.0",
-    "dotenv": "^16.4.5",
     "eslint": "^8.0.0",
     "tsx": "^4.0.0",
     "typescript": "^5.0.0"

package/quickmcp-direct-stdio.js

@@ -4,12 +4,19 @@ const path = require('path');
 const fs = require('fs');
 const os = require('os');
 const net = require('net');
-const dotenv = require('dotenv');
+let dotenv = null;
+try {
+  dotenv = require('dotenv');
+} catch (_) {
+  dotenv = null;
+}
 
-// Load .env from script directory first (works with Claude Desktop custom CWD),
-// then fallback to process CWD.
-dotenv.config({ path: path.join(__dirname, '.env') });
-dotenv.config();
+if (dotenv) {
+  // Load .env from script directory first (works with Claude Desktop custom CWD),
+  // then fallback to process CWD.
+  dotenv.config({ path: path.join(__dirname, '.env') });
+  dotenv.config();
+}
 
 let logger;
 try {
@@ -73,6 +80,16 @@ const wantsWeb = argv.includes('--web') || argv.includes('-w') || argv.includes(
 const noWeb = argv.includes('--no-web');
 const portArg = argv.find(a => a.startsWith('--port='));
 const dataDirArg = argv.find(a => a.startsWith('--data-dir='));
+
+function isProcessAlive(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (_) {
+    return false;
+  }
+}
 // Default behavior: Web UI enabled unless explicitly disabled
 if (noWeb || process.env.QUICKMCP_ENABLE_WEB === '0' || process.env.QUICKMCP_DISABLE_WEB === '1') {
   process.env.QUICKMCP_ENABLE_WEB = '0';
@@ -149,38 +166,69 @@ if (process.env.QUICKMCP_ENABLE_WEB === '1') {
     const preferredPort = parseInt(process.env.PORT || '3000', 10);
     const lockPath = path.join(runDir, `ui-${preferredPort}.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') {
-        logger.error('[QuickMCP] UI lock error (continuing without UI):', e.message || e);
+    const cleanup = () => { try { fs.unlinkSync(lockPath); } catch {} };
+    const tryAcquireLock = () => {
+      try {
+        const fd = fs.openSync(lockPath, 'wx');
+        fs.writeFileSync(fd, String(process.pid), 'utf8');
+        fs.closeSync(fd);
+        hasLock = true;
+        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') {
+          let ownerPid = NaN;
+          try {
+            ownerPid = parseInt(String(fs.readFileSync(lockPath, 'utf8')).trim(), 10);
+          } catch (_) {}
+
+          if (!isProcessAlive(ownerPid)) {
+            // Lock file exists but owner is gone (or lock format is empty/invalid): reclaim it.
+            try {
+              fs.unlinkSync(lockPath);
+              const fd = fs.openSync(lockPath, 'wx');
+              fs.writeFileSync(fd, String(process.pid), 'utf8');
+              fs.closeSync(fd);
+              hasLock = true;
+              process.once('exit', cleanup);
+              process.once('SIGINT', () => { cleanup(); process.exit(0); });
+              process.once('SIGTERM', () => { cleanup(); process.exit(0); });
+              logger.error(`[QuickMCP] Reclaimed stale UI lock: ${lockPath}`);
+              return;
+            } catch (reclaimErr) {
+              logger.error('[QuickMCP] Failed to reclaim stale UI lock (continuing without UI):', reclaimErr && reclaimErr.message ? reclaimErr.message : reclaimErr);
+              return;
+            }
+          }
+
+          logger.error(`[QuickMCP] UI lock held by pid ${ownerPid}; skipping Web UI in this process`);
+          return;
+        }
+
+        logger.error('[QuickMCP] UI lock error (continuing without UI):', e && e.message ? e.message : e);
       }
-      // Another process holds the UI lock; skip starting UI in this process
-    }
+    };
+    tryAcquireLock();
 
     if (!hasLock) {
-      logger.error('[QuickMCP] UI lock held by another process; skipping Web UI in this process');
+      logger.error('[QuickMCP] Web UI not started in this process');
     } else {
       // Only start Web UI if preferred port is actually free.
       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
+          logger.error(`[QuickMCP] Web UI port ${preferredPort} unavailable (${err.code}); skipping Web UI`);
           try { fs.unlinkSync(lockPath); } catch {}
           return;
         }
         // For other errors, still try starting server; better to attempt than silently skip for unknown cases
-        safeStartWebServer();
+        safeStartWebServer(preferredPort);
       });
       probe.once('listening', () => {
         probe.close(() => {
-          safeStartWebServer();
+          safeStartWebServer(preferredPort);
         });
       });
       try {
@@ -196,12 +244,13 @@ if (process.env.QUICKMCP_ENABLE_WEB === '1') {
 }
 
 // Start the web server but swallow a race-condition EADDRINUSE from Express listen
-function safeStartWebServer() {
+function safeStartWebServer(port) {
   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
+      logger.error(`[QuickMCP] Web UI port ${port || process.env.PORT || 3000} became busy during startup; continuing without UI`);
       process.removeListener('uncaughtException', handler);
       return;
     }
@@ -212,6 +261,7 @@ function safeStartWebServer() {
   // Install one-time handler to catch immediate async throw from Express
   process.prependOnceListener('uncaughtException', handler);
   try {
+    logger.error(`[QuickMCP] Starting Web UI at http://localhost:${port || process.env.PORT || 3000}`);
     require('./dist/server/server.js');
   } catch (e) {
     // Synchronous load error