@nimbus21.ai/chrome-devtools-mcp 0.17.4 → 0.17.5

package/build/src/browser.js

@@ -13,6 +13,36 @@ import { puppeteer } from './third_party/index.js';
 // Add stealth plugin
 puppeteerExtra.use(StealthPlugin());
 let browser;
+/**
+ * Close the browser instance, killing the Chrome process if we launched it.
+ * Safe to call multiple times or when no browser exists.
+ */
+export async function closeBrowser() {
+    if (!browser) {
+        return;
+    }
+    const b = browser;
+    browser = undefined;
+    try {
+        if (b.connected) {
+            // browser.close() sends a Browser.close CDP command and kills the process
+            // if it was launched by puppeteer. For connected browsers it just disconnects.
+            await b.close();
+        }
+    }
+    catch {
+        // Best-effort: if close fails, try to kill the process directly
+        try {
+            const proc = b.process();
+            if (proc && !proc.killed) {
+                proc.kill('SIGKILL');
+            }
+        }
+        catch {
+            // Nothing more we can do
+        }
+    }
+}
 function makeTargetFilter() {
     const ignoredPrefixes = new Set([
         'chrome://',

package/build/src/main.js

@@ -5,7 +5,7 @@
  */
 import './polyfill.js';
 import process from 'node:process';
-import { ensureBrowserConnected, ensureBrowserLaunched } from './browser.js';
+import { closeBrowser, ensureBrowserConnected, ensureBrowserLaunched } from './browser.js';
 import { cliOptions, parseArguments } from './cli.js';
 import { loadIssueDescriptions } from './issue-descriptions.js';
 import { logger, saveLogsToFile } from './logger.js';
@@ -195,6 +195,43 @@ await loadIssueDescriptions();
 const transport = new StdioServerTransport();
 await server.connect(transport);
 logger('Chrome DevTools MCP Server connected');
+// Graceful shutdown: kill Chrome when the MCP server exits for any reason.
+let shuttingDown = false;
+async function gracefulShutdown(reason) {
+    if (shuttingDown) {
+        return;
+    }
+    shuttingDown = true;
+    logger(`Shutting down: ${reason}`);
+    try {
+        context?.dispose();
+    }
+    catch {
+        // best-effort
+    }
+    try {
+        await closeBrowser();
+    }
+    catch {
+        // best-effort
+    }
+    logger('Shutdown complete');
+    process.exit(0);
+}
+// Handle OS signals (container stop, systemd, Ctrl+C)
+for (const signal of ['SIGTERM', 'SIGINT', 'SIGHUP']) {
+    process.on(signal, () => {
+        void gracefulShutdown(`received ${signal}`);
+    });
+}
+// Handle MCP client disconnect (transport/server close)
+server.server.onclose = () => {
+    void gracefulShutdown('MCP client disconnected');
+};
+// Handle stdin closing (parent process died)
+process.stdin.on('close', () => {
+    void gracefulShutdown('stdin closed');
+});
 logDisclaimers();
 void clearcutLogger?.logDailyActiveIfNeeded();
 void clearcutLogger?.logServerStart(computeFlagUsage(args, cliOptions));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbus21.ai/chrome-devtools-mcp",
-  "version": "0.17.4",
+  "version": "0.17.5",
   "description": "MCP server for Chrome DevTools with stealth mode support",
   "type": "module",
   "bin": "./build/src/index.js",