@mcpc-tech/unplugin-dev-inspector-mcp 0.0.42-beta.2 → 0.0.42-beta.4

package/README.md

@@ -125,12 +125,16 @@ If you prefer to configure it manually:
 +      enabled: true,
        showInspectorBar: true, // Default: true. Set to false to hide the UI.
 +      autoOpenBrowser: false, // Default: false. Automatically open browser when server starts.
++      // Disable Chrome DevTools integration (useful in CI/headless/cloud environments)
++      // disableChrome: true,
      }),
      react(), // or vue(), svelte(), solid(), preact()
    ],
  };
 ```
 
+> 📴 **Disable Chrome DevTools integration:** set `disableChrome: true` in plugin options or export `DEV_INSPECTOR_DISABLE_CHROME=1`.
+
 > ⚠️ **Plugin order matters:** Place `DevInspector.vite()` **before** `react()`, `vue()`, `svelte()`, `solid()`, or `preact()`. Otherwise source locations may show `unknown:0:0`.
 
 #### For Non-HTML Projects (Miniapps, Library Bundles)

package/dist/cli.cjs

@@ -113,6 +113,7 @@ async function startStandaloneServer(options = {}) {
 
 //#endregion
 //#region src/utils/config-detector.ts
+require_config_updater.init_helpers();
 const CONFIG_PATTERNS = {
 	vite: [
 		"vite.config.ts",
@@ -592,10 +593,15 @@ Example:
 		});
 		const serverContext = {
 			host: actualHost,
-			port: actualPort
+			port: actualPort,
+			disableChrome: require_config_updater.isEnvTruthy(process.env.DEV_INSPECTOR_DISABLE_CHROME)
 		};
 		const displayHost = actualHost === "0.0.0.0" ? "localhost" : actualHost;
-		const baseUrl = `${process.env.DEV_INSPECTOR_PUBLIC_BASE_URL ? process.env.DEV_INSPECTOR_PUBLIC_BASE_URL.replace(/\/+$/, "") : `http://${displayHost}:${actualPort}`}/__mcp__/sse`;
+		const baseUrl = `${require_config_updater.getPublicBaseUrl({
+			publicBaseUrl: process.env.DEV_INSPECTOR_PUBLIC_BASE_URL,
+			host: displayHost,
+			port: actualPort
+		})}/__mcp__/sse`;
 		console.log(`[dev-inspector] 📡 MCP (Standalone): ${baseUrl}\n`);
 		require_config_updater.setupMcpMiddleware(server, serverContext);
 		require_config_updater.setupAcpMiddleware(server, serverContext, {});

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as setupMcpMiddleware, n as setupAcpMiddleware, r as setupInspectorMiddleware, t as updateMcpConfigs } from "./config-updater.js";
+import { a as getPublicBaseUrl, c as isEnvTruthy, i as setupMcpMiddleware, n as setupAcpMiddleware, o as init_helpers, r as setupInspectorMiddleware, t as updateMcpConfigs } from "./config-updater.js";
 import http from "node:http";
 import { copyFileSync, existsSync, readFileSync, writeFileSync } from "fs";
 import { resolve } from "path";
@@ -109,6 +109,7 @@ async function startStandaloneServer(options = {}) {
 
 //#endregion
 //#region src/utils/config-detector.ts
+init_helpers();
 const CONFIG_PATTERNS = {
 	vite: [
 		"vite.config.ts",
@@ -588,10 +589,15 @@ Example:
 		});
 		const serverContext = {
 			host: actualHost,
-			port: actualPort
+			port: actualPort,
+			disableChrome: isEnvTruthy(process.env.DEV_INSPECTOR_DISABLE_CHROME)
 		};
 		const displayHost = actualHost === "0.0.0.0" ? "localhost" : actualHost;
-		const baseUrl = `${process.env.DEV_INSPECTOR_PUBLIC_BASE_URL ? process.env.DEV_INSPECTOR_PUBLIC_BASE_URL.replace(/\/+$/, "") : `http://${displayHost}:${actualPort}`}/__mcp__/sse`;
+		const baseUrl = `${getPublicBaseUrl({
+			publicBaseUrl: process.env.DEV_INSPECTOR_PUBLIC_BASE_URL,
+			host: displayHost,
+			port: actualPort
+		})}/__mcp__/sse`;
 		console.log(`[dev-inspector] 📡 MCP (Standalone): ${baseUrl}\n`);
 		setupMcpMiddleware(server, serverContext);
 		setupAcpMiddleware(server, serverContext, {});

package/dist/config-updater.cjs

@@ -86536,8 +86536,33 @@ const TOOL_SCHEMAS = {
 	}
 };
 
+//#endregion
+//#region src/utils/helpers.ts
+/**
+* Simple utility functions following KISS principle
+*/
+function stripTrailingSlash(url$1) {
+	return url$1.replace(/\/+$/, "");
+}
+function isEnvTruthy(value) {
+	if (!value) return false;
+	const normalized = value.trim().toLowerCase();
+	return normalized === "1" || normalized === "true" || normalized === "yes" || normalized === "on";
+}
+function isChromeDisabled(disableOption) {
+	return Boolean(disableOption) || isEnvTruthy(process.env.DEV_INSPECTOR_DISABLE_CHROME);
+}
+function getPublicBaseUrl(options) {
+	const fromEnv = process.env.DEV_INSPECTOR_PUBLIC_BASE_URL;
+	if (fromEnv) return stripTrailingSlash(fromEnv);
+	if (options?.publicBaseUrl) return stripTrailingSlash(options.publicBaseUrl);
+	return `http://${options?.host || "localhost"}:${options?.port || 5173}`;
+}
+var init_helpers = require_chunk.__esmMin((() => {}));
+
 //#endregion
 //#region src/mcp.ts
+init_helpers();
 /**
 * Get Chrome DevTools binary path from npm package, then use node to run it, faster/stabler than npx
 */
@@ -86580,6 +86605,7 @@ function callMcpMethod(mcpServer, method, params) {
 * Create and configure the MCP server for source inspection
 */
 async function createInspectorMcpServer(serverContext) {
+	const chromeDisabled = isChromeDisabled(serverContext?.disableChrome);
 	const mcpServer = await mcpc([{
 		name: "dev-inspector",
 		version: "1.0.0",
@@ -86588,7 +86614,7 @@ async function createInspectorMcpServer(serverContext) {
 		tools: { listChanged: true },
 		sampling: {},
 		prompts: { listChanged: true }
-	} }], [{
+	} }], chromeDisabled ? [] : [{
 		name: "chrome_devtools",
 		description: `Access Chrome DevTools for browser diagnostics.
 
@@ -86639,24 +86665,33 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 		{ ...TOOL_SCHEMAS.execute_page_script }
 	]);
 	mcpServer.setRequestHandler(_modelcontextprotocol_sdk_types_js.ListPromptsRequestSchema, async (_request) => {
-		const defaultUrl = process.env.DEV_INSPECTOR_PUBLIC_BASE_URL ? process.env.DEV_INSPECTOR_PUBLIC_BASE_URL.replace(/\/+$/, "") : `http://${serverContext?.host || "localhost"}:${serverContext?.port || 5173}`;
+		const defaultUrl = process.env.DEV_INSPECTOR_PUBLIC_BASE_URL ? stripTrailingSlash(process.env.DEV_INSPECTOR_PUBLIC_BASE_URL) : `http://${serverContext?.host || "localhost"}:${serverContext?.port || 5173}`;
 		return { prompts: [
 			{ ...PROMPT_SCHEMAS.capture_element },
 			{ ...PROMPT_SCHEMAS.view_inspections },
-			{
-				...PROMPT_SCHEMAS.launch_chrome_devtools,
-				description: `Launch Chrome DevTools and navigate to the dev server for debugging and inspection. Default URL: ${defaultUrl}. You can use this default URL or provide a custom one.`,
-				arguments: [{
-					name: "url",
-					description: `The URL to navigate to. Press Enter to use default: ${defaultUrl}`,
-					required: false
-				}]
-			},
-			{ ...PROMPT_SCHEMAS.get_network_requests },
-			{ ...PROMPT_SCHEMAS.get_console_messages }
+			...!chromeDisabled ? [
+				{
+					...PROMPT_SCHEMAS.launch_chrome_devtools,
+					description: `Launch Chrome DevTools and navigate to the dev server for debugging and inspection. Default URL: ${defaultUrl}. You can use this default URL or provide a custom one.`,
+					arguments: [{
+						name: "url",
+						description: `The URL to navigate to. Press Enter to use default: ${defaultUrl}`,
+						required: false
+					}]
+				},
+				{ ...PROMPT_SCHEMAS.get_network_requests },
+				{ ...PROMPT_SCHEMAS.get_console_messages }
+			] : []
 		] };
 	});
 	async function refreshChromeState() {
+		if (chromeDisabled) return { messages: [{
+			role: "user",
+			content: {
+				type: "text",
+				text: "Chrome integration is disabled (set DEV_INSPECTOR_DISABLE_CHROME=0 to enable)."
+			}
+		}] };
 		const networkResult = await callMcpMethod(mcpServer, "tools/call", {
 			name: "chrome_devtools",
 			arguments: {
@@ -86687,23 +86722,25 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 			return { prompts: [
 				{ ...PROMPT_SCHEMAS.capture_element },
 				{ ...PROMPT_SCHEMAS.view_inspections },
-				{ ...PROMPT_SCHEMAS.launch_chrome_devtools },
-				{
-					...PROMPT_SCHEMAS.get_network_requests,
-					arguments: [{
-						name: "reqid",
-						description: `Optional. The request ID to get details for. If omitted, only refreshes and lists requests.\n\nAvailable requests:\n${requestOptions || "No requests available"}`,
-						required: false
-					}]
-				},
-				{
-					...PROMPT_SCHEMAS.get_console_messages,
-					arguments: [{
-						name: "msgid",
-						description: `Optional. The message ID to get details for. If omitted, only refreshes and lists messages.\n\nAvailable messages:\n${messageOptions || "No messages available"}`,
-						required: false
-					}]
-				}
+				...!chromeDisabled ? [
+					{ ...PROMPT_SCHEMAS.launch_chrome_devtools },
+					{
+						...PROMPT_SCHEMAS.get_network_requests,
+						arguments: [{
+							name: "reqid",
+							description: `Optional. The request ID to get details for. If omitted, only refreshes and lists requests.\n\nAvailable requests:\n${requestOptions || "No requests available"}`,
+							required: false
+						}]
+					},
+					{
+						...PROMPT_SCHEMAS.get_console_messages,
+						arguments: [{
+							name: "msgid",
+							description: `Optional. The message ID to get details for. If omitted, only refreshes and lists messages.\n\nAvailable messages:\n${messageOptions || "No messages available"}`,
+							required: false
+						}]
+					}
+				] : []
 			] };
 		});
 		await mcpServer.sendPromptListChanged();
@@ -86714,6 +86751,13 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 	}
 	mcpServer.setRequestHandler(_modelcontextprotocol_sdk_types_js.GetPromptRequestSchema, async (request) => {
 		const promptName = request.params.name;
+		if (chromeDisabled && (promptName === "launch_chrome_devtools" || promptName === "get_network_requests" || promptName === "get_console_messages")) return { messages: [{
+			role: "user",
+			content: {
+				type: "text",
+				text: "Chrome integration is disabled. Enable it by unsetting DEV_INSPECTOR_DISABLE_CHROME or setting it to 0/false."
+			}
+		}] };
 		switch (promptName) {
 			case "capture_element": return { messages: (await callMcpMethod(mcpServer, "tools/call", {
 				name: "capture_element_context",
@@ -86730,7 +86774,7 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 				content: item
 			})) || [] };
 			case "launch_chrome_devtools": {
-				const defaultUrl = process.env.DEV_INSPECTOR_PUBLIC_BASE_URL ? process.env.DEV_INSPECTOR_PUBLIC_BASE_URL.replace(/\/+$/, "") : `http://${serverContext?.host || "localhost"}:${serverContext?.port || 5173}`;
+				const defaultUrl = process.env.DEV_INSPECTOR_PUBLIC_BASE_URL ? stripTrailingSlash(process.env.DEV_INSPECTOR_PUBLIC_BASE_URL) : `http://${serverContext?.host || "localhost"}:${serverContext?.port || 5173}`;
 				const url$1 = request.params.arguments?.url || defaultUrl;
 				try {
 					new URL(url$1);
@@ -87088,18 +87132,6 @@ async function handleStreamableHttpDelete(req, res, connectionManager) {
 */
 async function handleSseConnection(req, res, serverContext, connectionManager) {
 	try {
-		if (!res.headersSent) {
-			res.statusCode = 200;
-			res.setHeader("Content-Type", "text/event-stream; charset=utf-8");
-			res.setHeader("Cache-Control", "no-cache, no-transform");
-			res.setHeader("Connection", "keep-alive");
-			res.setHeader("X-Accel-Buffering", "no");
-			res.setHeader("Content-Encoding", "identity");
-		}
-		res.socket?.setKeepAlive?.(true);
-		res.socket?.setTimeout?.(0);
-		res.flushHeaders?.();
-		res.write(`: mcp-sse-connected\n\n`);
 		const mcpServer = await createInspectorMcpServer(serverContext);
 		const host = serverContext?.host || "localhost";
 		const port = serverContext?.port || 5173;
@@ -87118,6 +87150,9 @@ async function handleSseConnection(req, res, serverContext, connectionManager) {
 			connectionManager.handleWatcherConnection(sessionId, clientId, puppetId, transport);
 		}
 		await mcpServer.connect(transport);
+		try {
+			res.write(`: mcp-sse-connected\n\n`);
+		} catch {}
 	} catch (error) {
 		console.error("Error establishing SSE connection:", error);
 		if (!res.headersSent) res.writeHead(500).end("Error establishing SSE stream");
@@ -88904,6 +88939,30 @@ async function updateMcpConfigs(root$1, sseUrl, options, logger) {
 }
 
 //#endregion
+Object.defineProperty(exports, 'getPublicBaseUrl', {
+  enumerable: true,
+  get: function () {
+    return getPublicBaseUrl;
+  }
+});
+Object.defineProperty(exports, 'init_helpers', {
+  enumerable: true,
+  get: function () {
+    return init_helpers;
+  }
+});
+Object.defineProperty(exports, 'isChromeDisabled', {
+  enumerable: true,
+  get: function () {
+    return isChromeDisabled;
+  }
+});
+Object.defineProperty(exports, 'isEnvTruthy', {
+  enumerable: true,
+  get: function () {
+    return isEnvTruthy;
+  }
+});
 Object.defineProperty(exports, 'setupAcpMiddleware', {
   enumerable: true,
   get: function () {
@@ -88922,6 +88981,12 @@ Object.defineProperty(exports, 'setupMcpMiddleware', {
     return setupMcpMiddleware;
   }
 });
+Object.defineProperty(exports, 'stripTrailingSlash', {
+  enumerable: true,
+  get: function () {
+    return stripTrailingSlash;
+  }
+});
 Object.defineProperty(exports, 'updateMcpConfigs', {
   enumerable: true,
   get: function () {

package/dist/config-updater.js

@@ -86571,8 +86571,33 @@ const TOOL_SCHEMAS = {
 	}
 };
 
+//#endregion
+//#region src/utils/helpers.ts
+/**
+* Simple utility functions following KISS principle
+*/
+function stripTrailingSlash(url) {
+	return url.replace(/\/+$/, "");
+}
+function isEnvTruthy(value) {
+	if (!value) return false;
+	const normalized = value.trim().toLowerCase();
+	return normalized === "1" || normalized === "true" || normalized === "yes" || normalized === "on";
+}
+function isChromeDisabled(disableOption) {
+	return Boolean(disableOption) || isEnvTruthy(process.env.DEV_INSPECTOR_DISABLE_CHROME);
+}
+function getPublicBaseUrl(options) {
+	const fromEnv = process.env.DEV_INSPECTOR_PUBLIC_BASE_URL;
+	if (fromEnv) return stripTrailingSlash(fromEnv);
+	if (options?.publicBaseUrl) return stripTrailingSlash(options.publicBaseUrl);
+	return `http://${options?.host || "localhost"}:${options?.port || 5173}`;
+}
+var init_helpers = __esmMin((() => {}));
+
 //#endregion
 //#region src/mcp.ts
+init_helpers();
 /**
 * Get Chrome DevTools binary path from npm package, then use node to run it, faster/stabler than npx
 */
@@ -86615,6 +86640,7 @@ function callMcpMethod(mcpServer, method, params) {
 * Create and configure the MCP server for source inspection
 */
 async function createInspectorMcpServer(serverContext) {
+	const chromeDisabled = isChromeDisabled(serverContext?.disableChrome);
 	const mcpServer = await mcpc([{
 		name: "dev-inspector",
 		version: "1.0.0",
@@ -86623,7 +86649,7 @@ async function createInspectorMcpServer(serverContext) {
 		tools: { listChanged: true },
 		sampling: {},
 		prompts: { listChanged: true }
-	} }], [{
+	} }], chromeDisabled ? [] : [{
 		name: "chrome_devtools",
 		description: `Access Chrome DevTools for browser diagnostics.
 
@@ -86674,24 +86700,33 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 		{ ...TOOL_SCHEMAS.execute_page_script }
 	]);
 	mcpServer.setRequestHandler(ListPromptsRequestSchema, async (_request) => {
-		const defaultUrl = process.env.DEV_INSPECTOR_PUBLIC_BASE_URL ? process.env.DEV_INSPECTOR_PUBLIC_BASE_URL.replace(/\/+$/, "") : `http://${serverContext?.host || "localhost"}:${serverContext?.port || 5173}`;
+		const defaultUrl = process.env.DEV_INSPECTOR_PUBLIC_BASE_URL ? stripTrailingSlash(process.env.DEV_INSPECTOR_PUBLIC_BASE_URL) : `http://${serverContext?.host || "localhost"}:${serverContext?.port || 5173}`;
 		return { prompts: [
 			{ ...PROMPT_SCHEMAS.capture_element },
 			{ ...PROMPT_SCHEMAS.view_inspections },
-			{
-				...PROMPT_SCHEMAS.launch_chrome_devtools,
-				description: `Launch Chrome DevTools and navigate to the dev server for debugging and inspection. Default URL: ${defaultUrl}. You can use this default URL or provide a custom one.`,
-				arguments: [{
-					name: "url",
-					description: `The URL to navigate to. Press Enter to use default: ${defaultUrl}`,
-					required: false
-				}]
-			},
-			{ ...PROMPT_SCHEMAS.get_network_requests },
-			{ ...PROMPT_SCHEMAS.get_console_messages }
+			...!chromeDisabled ? [
+				{
+					...PROMPT_SCHEMAS.launch_chrome_devtools,
+					description: `Launch Chrome DevTools and navigate to the dev server for debugging and inspection. Default URL: ${defaultUrl}. You can use this default URL or provide a custom one.`,
+					arguments: [{
+						name: "url",
+						description: `The URL to navigate to. Press Enter to use default: ${defaultUrl}`,
+						required: false
+					}]
+				},
+				{ ...PROMPT_SCHEMAS.get_network_requests },
+				{ ...PROMPT_SCHEMAS.get_console_messages }
+			] : []
 		] };
 	});
 	async function refreshChromeState() {
+		if (chromeDisabled) return { messages: [{
+			role: "user",
+			content: {
+				type: "text",
+				text: "Chrome integration is disabled (set DEV_INSPECTOR_DISABLE_CHROME=0 to enable)."
+			}
+		}] };
 		const networkResult = await callMcpMethod(mcpServer, "tools/call", {
 			name: "chrome_devtools",
 			arguments: {
@@ -86722,23 +86757,25 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 			return { prompts: [
 				{ ...PROMPT_SCHEMAS.capture_element },
 				{ ...PROMPT_SCHEMAS.view_inspections },
-				{ ...PROMPT_SCHEMAS.launch_chrome_devtools },
-				{
-					...PROMPT_SCHEMAS.get_network_requests,
-					arguments: [{
-						name: "reqid",
-						description: `Optional. The request ID to get details for. If omitted, only refreshes and lists requests.\n\nAvailable requests:\n${requestOptions || "No requests available"}`,
-						required: false
-					}]
-				},
-				{
-					...PROMPT_SCHEMAS.get_console_messages,
-					arguments: [{
-						name: "msgid",
-						description: `Optional. The message ID to get details for. If omitted, only refreshes and lists messages.\n\nAvailable messages:\n${messageOptions || "No messages available"}`,
-						required: false
-					}]
-				}
+				...!chromeDisabled ? [
+					{ ...PROMPT_SCHEMAS.launch_chrome_devtools },
+					{
+						...PROMPT_SCHEMAS.get_network_requests,
+						arguments: [{
+							name: "reqid",
+							description: `Optional. The request ID to get details for. If omitted, only refreshes and lists requests.\n\nAvailable requests:\n${requestOptions || "No requests available"}`,
+							required: false
+						}]
+					},
+					{
+						...PROMPT_SCHEMAS.get_console_messages,
+						arguments: [{
+							name: "msgid",
+							description: `Optional. The message ID to get details for. If omitted, only refreshes and lists messages.\n\nAvailable messages:\n${messageOptions || "No messages available"}`,
+							required: false
+						}]
+					}
+				] : []
 			] };
 		});
 		await mcpServer.sendPromptListChanged();
@@ -86749,6 +86786,13 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 	}
 	mcpServer.setRequestHandler(GetPromptRequestSchema, async (request) => {
 		const promptName = request.params.name;
+		if (chromeDisabled && (promptName === "launch_chrome_devtools" || promptName === "get_network_requests" || promptName === "get_console_messages")) return { messages: [{
+			role: "user",
+			content: {
+				type: "text",
+				text: "Chrome integration is disabled. Enable it by unsetting DEV_INSPECTOR_DISABLE_CHROME or setting it to 0/false."
+			}
+		}] };
 		switch (promptName) {
 			case "capture_element": return { messages: (await callMcpMethod(mcpServer, "tools/call", {
 				name: "capture_element_context",
@@ -86765,7 +86809,7 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 				content: item
 			})) || [] };
 			case "launch_chrome_devtools": {
-				const defaultUrl = process.env.DEV_INSPECTOR_PUBLIC_BASE_URL ? process.env.DEV_INSPECTOR_PUBLIC_BASE_URL.replace(/\/+$/, "") : `http://${serverContext?.host || "localhost"}:${serverContext?.port || 5173}`;
+				const defaultUrl = process.env.DEV_INSPECTOR_PUBLIC_BASE_URL ? stripTrailingSlash(process.env.DEV_INSPECTOR_PUBLIC_BASE_URL) : `http://${serverContext?.host || "localhost"}:${serverContext?.port || 5173}`;
 				const url = request.params.arguments?.url || defaultUrl;
 				try {
 					new URL(url);
@@ -87123,18 +87167,6 @@ async function handleStreamableHttpDelete(req, res, connectionManager) {
 */
 async function handleSseConnection(req, res, serverContext, connectionManager) {
 	try {
-		if (!res.headersSent) {
-			res.statusCode = 200;
-			res.setHeader("Content-Type", "text/event-stream; charset=utf-8");
-			res.setHeader("Cache-Control", "no-cache, no-transform");
-			res.setHeader("Connection", "keep-alive");
-			res.setHeader("X-Accel-Buffering", "no");
-			res.setHeader("Content-Encoding", "identity");
-		}
-		res.socket?.setKeepAlive?.(true);
-		res.socket?.setTimeout?.(0);
-		res.flushHeaders?.();
-		res.write(`: mcp-sse-connected\n\n`);
 		const mcpServer = await createInspectorMcpServer(serverContext);
 		const host = serverContext?.host || "localhost";
 		const port = serverContext?.port || 5173;
@@ -87153,6 +87185,9 @@ async function handleSseConnection(req, res, serverContext, connectionManager) {
 			connectionManager.handleWatcherConnection(sessionId, clientId, puppetId, transport);
 		}
 		await mcpServer.connect(transport);
+		try {
+			res.write(`: mcp-sse-connected\n\n`);
+		} catch {}
 	} catch (error) {
 		console.error("Error establishing SSE connection:", error);
 		if (!res.headersSent) res.writeHead(500).end("Error establishing SSE stream");
@@ -88939,4 +88974,4 @@ async function updateMcpConfigs(root$1, sseUrl, options, logger) {
 }
 
 //#endregion
-export { __esmMin as a, setupMcpMiddleware as i, setupAcpMiddleware as n, __export as o, setupInspectorMiddleware as r, __toCommonJS as s, updateMcpConfigs as t };
+export { getPublicBaseUrl as a, isEnvTruthy as c, __export as d, __toCommonJS as f, setupMcpMiddleware as i, stripTrailingSlash as l, setupAcpMiddleware as n, init_helpers as o, setupInspectorMiddleware as r, isChromeDisabled as s, updateMcpConfigs as t, __esmMin as u };

package/dist/index.cjs

@@ -72,6 +72,10 @@ async function getOrCreateClient(sseUrl) {
 */
 async function launchBrowserWithDevTools(options) {
 	const { url, serverContext } = options;
+	if (require_config_updater.isChromeDisabled(serverContext.disableChrome)) {
+		console.log(`[dev-inspector] 📴 Skipping browser launch: Chrome integration disabled (DEV_INSPECTOR_DISABLE_CHROME=1 or disableChrome: true)`);
+		return false;
+	}
 	const sseUrl = `http://${serverContext.host === "0.0.0.0" ? "localhost" : serverContext.host || "localhost"}:${serverContext.port || 5173}/__mcp__/sse?clientId=browser-launcher-${process.pid}`;
 	try {
 		await (await getOrCreateClient(sseUrl)).callTool({
@@ -90,6 +94,7 @@ async function launchBrowserWithDevTools(options) {
 }
 var sharedClient, sharedSseUrl, connectPromise, cleanupRegistered;
 var init_browser_launcher = require_chunk.__esmMin((() => {
+	require_config_updater.init_helpers();
 	sharedClient = null;
 	sharedSseUrl = null;
 	connectPromise = null;
@@ -99,6 +104,7 @@ var init_browser_launcher = require_chunk.__esmMin((() => {
 //#endregion
 //#region src/utils/create-plugin.ts
 init_browser_launcher();
+require_config_updater.init_helpers();
 const createDevInspectorPlugin = (name, transformFactory) => {
 	return (0, unplugin.createUnplugin)((options = {}) => {
 		const enabled = options.enabled ?? process.env.NODE_ENV !== "production";
@@ -108,11 +114,7 @@ const createDevInspectorPlugin = (name, transformFactory) => {
 		let resolvedHost = options.host || "localhost";
 		let resolvedPort = options.port || 5173;
 		const transformImpl = transformFactory(options);
-		const stripTrailingSlash = (url) => url.replace(/\/+$/, "");
-		const getPublicBaseUrl = (fallbackHttpHostPort) => {
-			const fromOptions = options.publicBaseUrl || process.env.DEV_INSPECTOR_PUBLIC_BASE_URL;
-			return fromOptions ? stripTrailingSlash(fromOptions) : fallbackHttpHostPort;
-		};
+		const chromeDisabled = require_config_updater.isChromeDisabled(options.disableChrome);
 		const transform = (code, id) => {
 			if (!enabled) return null;
 			if (viteCommand && viteCommand !== "serve") return null;
@@ -139,7 +141,7 @@ export function registerInspectorTool(_tool) {
 					const port = resolvedPort;
 					const showInspectorBar = options.showInspectorBar ?? true;
 					const publicBaseUrl = options.publicBaseUrl || process.env.DEV_INSPECTOR_PUBLIC_BASE_URL;
-					const injectedBaseUrl = publicBaseUrl ? stripTrailingSlash(publicBaseUrl) : void 0;
+					const injectedBaseUrl = publicBaseUrl ? require_config_updater.stripTrailingSlash(publicBaseUrl) : void 0;
 					return `
 // Development-only code - removed in production builds
 
@@ -258,9 +260,15 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 					const viteHost = server.config.server.host;
 					const serverContext = {
 						host: options.host ?? (typeof viteHost === "string" ? viteHost : viteHost === true ? "0.0.0.0" : "localhost"),
-						port: options.port ?? server.config.server.port ?? 5173
+						port: options.port ?? server.config.server.port ?? 5173,
+						disableChrome: chromeDisabled
 					};
-					const publicBase = getPublicBaseUrl(`http://${serverContext.host === "0.0.0.0" ? "localhost" : serverContext.host}:${serverContext.port}`);
+					const displayHost = serverContext.host === "0.0.0.0" ? "localhost" : serverContext.host;
+					const publicBase = require_config_updater.getPublicBaseUrl({
+						publicBaseUrl: options.publicBaseUrl,
+						host: displayHost,
+						port: serverContext.port
+					});
 					const baseUrl = `${publicBase}/__mcp__/sse`;
 					console.log(`[dev-inspector] 📡 MCP: ${baseUrl}\n`);
 					await require_config_updater.setupMcpMiddleware(server.middlewares, serverContext);
@@ -276,7 +284,7 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 						updateConfigAdditionalServers: options.updateConfigAdditionalServers,
 						customEditors: options.customEditors
 					});
-					if (options.autoOpenBrowser ?? false) {
+					if ((options.autoOpenBrowser ?? false) && !chromeDisabled) {
 						const targetUrl = options.browserUrl ?? publicBase;
 						setTimeout(async () => {
 							if (await launchBrowserWithDevTools({
@@ -285,7 +293,8 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 							})) console.log(`[dev-inspector] 🌐 Browser opened: ${targetUrl}`);
 							else console.log(`[dev-inspector] 💡 Use "launch_chrome_devtools" prompt to open browser manually.\n`);
 						}, 1e3);
-					} else {
+					} else if (chromeDisabled) console.log(`[dev-inspector] 📴 Chrome integration disabled (DEV_INSPECTOR_DISABLE_CHROME=1 or disableChrome: true)`);
+					else {
 						console.log(`[dev-inspector] ⚠️  autoOpenBrowser: false - Console/Network context unavailable`);
 						console.log(`[dev-inspector] 💡 Use "launch_chrome_devtools" prompt or "chrome_devtools" tool to open browser manually.\n`);
 					}
@@ -316,9 +325,15 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 						}
 						const serverContext = {
 							host,
-							port
+							port,
+							disableChrome: chromeDisabled
 						};
-						const publicBase = getPublicBaseUrl(`http://${host === "0.0.0.0" ? "localhost" : host}:${port}`);
+						const displayHost = host === "0.0.0.0" ? "localhost" : host;
+						const publicBase = require_config_updater.getPublicBaseUrl({
+							publicBaseUrl: options.publicBaseUrl,
+							host: displayHost,
+							port
+						});
 						const baseUrl = `${publicBase}/__mcp__/sse`;
 						console.log(`[dev-inspector] 📡 MCP (Standalone): ${baseUrl}\n`);
 						require_config_updater.setupMcpMiddleware(server, serverContext);
@@ -334,7 +349,7 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 							updateConfigAdditionalServers: options.updateConfigAdditionalServers,
 							customEditors: options.customEditors
 						});
-						if (options.autoOpenBrowser ?? false) {
+						if ((options.autoOpenBrowser ?? false) && !chromeDisabled) {
 							const targetUrl = options.browserUrl ?? publicBase;
 							console.log(`[dev-inspector] 🔄 Auto-opening browser in 1s...`);
 							setTimeout(async () => {
@@ -348,7 +363,8 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 									console.error(`[dev-inspector] ❌ Browser launch error:`, err);
 								}
 							}, 1e3);
-						} else {
+						} else if (chromeDisabled) console.log(`[dev-inspector] 📴 Chrome integration disabled (DEV_INSPECTOR_DISABLE_CHROME=1 or disableChrome: true)`);
+						else {
 							console.log(`[dev-inspector] ⚠️  autoOpenBrowser: false - Console/Network context unavailable`);
 							console.log(`[dev-inspector] 💡 Use "launch_chrome_devtools" prompt to enable.\n`);
 						}
@@ -629,6 +645,7 @@ const unpluginExternal = createDevInspectorPlugin("unplugin-dev-inspector-extern
 
 //#endregion
 //#region src/turbopack.ts
+require_config_updater.init_helpers();
 let browserLaunchScheduled = false;
 /**
 * Returns the Turbopack rules config for dev-inspector.
@@ -651,8 +668,10 @@ function turbopackDevInspector(options = {}) {
 	} catch {
 		loaderPath = "./loader.js";
 	}
-	if (!(options.enabled ?? process.env.NODE_ENV !== "production")) return {};
-	if (options.autoOpenBrowser && !browserLaunchScheduled && typeof process !== "undefined" && process.env.NODE_ENV !== "production") {
+	const enabled = options.enabled ?? process.env.NODE_ENV !== "production";
+	const chromeDisabled = require_config_updater.isChromeDisabled(options.disableChrome);
+	if (!enabled) return {};
+	if (options.autoOpenBrowser && !chromeDisabled && !browserLaunchScheduled && typeof process !== "undefined" && process.env.NODE_ENV !== "production") {
 		browserLaunchScheduled = true;
 		const { launchBrowserWithDevTools: launchBrowserWithDevTools$1 } = (init_browser_launcher(), require_chunk.__toCommonJS(browser_launcher_exports));
 		const host = options.host || "localhost";

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import * as unplugin0 from "unplugin";
+import * as unplugin1 from "unplugin";
 
 //#region src/utils/config-updater.d.ts
 type EditorId = "cursor" | "vscode" | "windsurf" | "claude-code" | "antigravity";
@@ -162,6 +162,12 @@ interface DevInspectorOptions extends McpConfigOptions, AcpOptions {
    * @default false
    */
   autoOpenBrowser?: boolean;
+  /**
+   * Disable Chrome DevTools integration entirely (chrome_devtools tool + related prompts).
+   * Can also be controlled via DEV_INSPECTOR_DISABLE_CHROME=1
+   * @default false
+   */
+  disableChrome?: boolean;
   /**
    * Custom browser launch URL
    * If not specified, uses the dev server URL (e.g., http://localhost:5173)
@@ -177,10 +183,10 @@ interface DevInspectorOptions extends McpConfigOptions, AcpOptions {
 }
 //#endregion
 //#region src/core.d.ts
-declare const unplugin: unplugin0.UnpluginInstance<DevInspectorOptions | undefined, boolean>;
+declare const unplugin: unplugin1.UnpluginInstance<DevInspectorOptions | undefined, boolean>;
 //#endregion
 //#region src/core-external.d.ts
-declare const unpluginExternal: unplugin0.UnpluginInstance<DevInspectorOptions | undefined, boolean>;
+declare const unpluginExternal: unplugin1.UnpluginInstance<DevInspectorOptions | undefined, boolean>;
 //#endregion
 //#region src/turbopack.d.ts
 interface TurbopackDevInspectorOptions extends DevInspectorOptions {
@@ -205,7 +211,7 @@ interface TurbopackDevInspectorOptions extends DevInspectorOptions {
 declare function turbopackDevInspector(options?: TurbopackDevInspectorOptions): any;
 //#endregion
 //#region src/index.d.ts
-declare const external: unplugin0.UnpluginInstance<DevInspectorOptions | undefined, boolean>;
+declare const external: unplugin1.UnpluginInstance<DevInspectorOptions | undefined, boolean>;
 declare module "virtual:dev-inspector-mcp" {}
 //#endregion
 export { type CustomEditorConfig, type DevInspectorOptions, type EditorId, type McpConfigOptions, type TurbopackDevInspectorOptions, unplugin as default, unplugin, external, turbopackDevInspector, unpluginExternal };

package/dist/index.d.ts

@@ -162,6 +162,12 @@ interface DevInspectorOptions extends McpConfigOptions, AcpOptions {
    * @default false
    */
   autoOpenBrowser?: boolean;
+  /**
+   * Disable Chrome DevTools integration entirely (chrome_devtools tool + related prompts).
+   * Can also be controlled via DEV_INSPECTOR_DISABLE_CHROME=1
+   * @default false
+   */
+  disableChrome?: boolean;
   /**
    * Custom browser launch URL
    * If not specified, uses the dev server URL (e.g., http://localhost:5173)

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as __esmMin, i as setupMcpMiddleware, n as setupAcpMiddleware, o as __export, r as setupInspectorMiddleware, s as __toCommonJS, t as updateMcpConfigs } from "./config-updater.js";
+import { a as getPublicBaseUrl, d as __export, f as __toCommonJS, i as setupMcpMiddleware, l as stripTrailingSlash, n as setupAcpMiddleware, o as init_helpers, r as setupInspectorMiddleware, s as isChromeDisabled, t as updateMcpConfigs, u as __esmMin } from "./config-updater.js";
 import { createRequire } from "node:module";
 import path from "node:path";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
@@ -68,6 +68,10 @@ async function getOrCreateClient(sseUrl) {
 */
 async function launchBrowserWithDevTools(options) {
 	const { url, serverContext } = options;
+	if (isChromeDisabled(serverContext.disableChrome)) {
+		console.log(`[dev-inspector] 📴 Skipping browser launch: Chrome integration disabled (DEV_INSPECTOR_DISABLE_CHROME=1 or disableChrome: true)`);
+		return false;
+	}
 	const sseUrl = `http://${serverContext.host === "0.0.0.0" ? "localhost" : serverContext.host || "localhost"}:${serverContext.port || 5173}/__mcp__/sse?clientId=browser-launcher-${process.pid}`;
 	try {
 		await (await getOrCreateClient(sseUrl)).callTool({
@@ -86,6 +90,7 @@ async function launchBrowserWithDevTools(options) {
 }
 var sharedClient, sharedSseUrl, connectPromise, cleanupRegistered;
 var init_browser_launcher = __esmMin((() => {
+	init_helpers();
 	sharedClient = null;
 	sharedSseUrl = null;
 	connectPromise = null;
@@ -95,6 +100,7 @@ var init_browser_launcher = __esmMin((() => {
 //#endregion
 //#region src/utils/create-plugin.ts
 init_browser_launcher();
+init_helpers();
 const createDevInspectorPlugin = (name, transformFactory) => {
 	return createUnplugin((options = {}) => {
 		const enabled = options.enabled ?? process.env.NODE_ENV !== "production";
@@ -104,11 +110,7 @@ const createDevInspectorPlugin = (name, transformFactory) => {
 		let resolvedHost = options.host || "localhost";
 		let resolvedPort = options.port || 5173;
 		const transformImpl = transformFactory(options);
-		const stripTrailingSlash = (url) => url.replace(/\/+$/, "");
-		const getPublicBaseUrl = (fallbackHttpHostPort) => {
-			const fromOptions = options.publicBaseUrl || process.env.DEV_INSPECTOR_PUBLIC_BASE_URL;
-			return fromOptions ? stripTrailingSlash(fromOptions) : fallbackHttpHostPort;
-		};
+		const chromeDisabled = isChromeDisabled(options.disableChrome);
 		const transform = (code, id) => {
 			if (!enabled) return null;
 			if (viteCommand && viteCommand !== "serve") return null;
@@ -254,9 +256,15 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 					const viteHost = server.config.server.host;
 					const serverContext = {
 						host: options.host ?? (typeof viteHost === "string" ? viteHost : viteHost === true ? "0.0.0.0" : "localhost"),
-						port: options.port ?? server.config.server.port ?? 5173
+						port: options.port ?? server.config.server.port ?? 5173,
+						disableChrome: chromeDisabled
 					};
-					const publicBase = getPublicBaseUrl(`http://${serverContext.host === "0.0.0.0" ? "localhost" : serverContext.host}:${serverContext.port}`);
+					const displayHost = serverContext.host === "0.0.0.0" ? "localhost" : serverContext.host;
+					const publicBase = getPublicBaseUrl({
+						publicBaseUrl: options.publicBaseUrl,
+						host: displayHost,
+						port: serverContext.port
+					});
 					const baseUrl = `${publicBase}/__mcp__/sse`;
 					console.log(`[dev-inspector] 📡 MCP: ${baseUrl}\n`);
 					await setupMcpMiddleware(server.middlewares, serverContext);
@@ -272,7 +280,7 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 						updateConfigAdditionalServers: options.updateConfigAdditionalServers,
 						customEditors: options.customEditors
 					});
-					if (options.autoOpenBrowser ?? false) {
+					if ((options.autoOpenBrowser ?? false) && !chromeDisabled) {
 						const targetUrl = options.browserUrl ?? publicBase;
 						setTimeout(async () => {
 							if (await launchBrowserWithDevTools({
@@ -281,7 +289,8 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 							})) console.log(`[dev-inspector] 🌐 Browser opened: ${targetUrl}`);
 							else console.log(`[dev-inspector] 💡 Use "launch_chrome_devtools" prompt to open browser manually.\n`);
 						}, 1e3);
-					} else {
+					} else if (chromeDisabled) console.log(`[dev-inspector] 📴 Chrome integration disabled (DEV_INSPECTOR_DISABLE_CHROME=1 or disableChrome: true)`);
+					else {
 						console.log(`[dev-inspector] ⚠️  autoOpenBrowser: false - Console/Network context unavailable`);
 						console.log(`[dev-inspector] 💡 Use "launch_chrome_devtools" prompt or "chrome_devtools" tool to open browser manually.\n`);
 					}
@@ -312,9 +321,15 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 						}
 						const serverContext = {
 							host,
-							port
+							port,
+							disableChrome: chromeDisabled
 						};
-						const publicBase = getPublicBaseUrl(`http://${host === "0.0.0.0" ? "localhost" : host}:${port}`);
+						const displayHost = host === "0.0.0.0" ? "localhost" : host;
+						const publicBase = getPublicBaseUrl({
+							publicBaseUrl: options.publicBaseUrl,
+							host: displayHost,
+							port
+						});
 						const baseUrl = `${publicBase}/__mcp__/sse`;
 						console.log(`[dev-inspector] 📡 MCP (Standalone): ${baseUrl}\n`);
 						setupMcpMiddleware(server, serverContext);
@@ -330,7 +345,7 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 							updateConfigAdditionalServers: options.updateConfigAdditionalServers,
 							customEditors: options.customEditors
 						});
-						if (options.autoOpenBrowser ?? false) {
+						if ((options.autoOpenBrowser ?? false) && !chromeDisabled) {
 							const targetUrl = options.browserUrl ?? publicBase;
 							console.log(`[dev-inspector] 🔄 Auto-opening browser in 1s...`);
 							setTimeout(async () => {
@@ -344,7 +359,8 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 									console.error(`[dev-inspector] ❌ Browser launch error:`, err);
 								}
 							}, 1e3);
-						} else {
+						} else if (chromeDisabled) console.log(`[dev-inspector] 📴 Chrome integration disabled (DEV_INSPECTOR_DISABLE_CHROME=1 or disableChrome: true)`);
+						else {
 							console.log(`[dev-inspector] ⚠️  autoOpenBrowser: false - Console/Network context unavailable`);
 							console.log(`[dev-inspector] 💡 Use "launch_chrome_devtools" prompt to enable.\n`);
 						}
@@ -625,6 +641,7 @@ const unpluginExternal = createDevInspectorPlugin("unplugin-dev-inspector-extern
 
 //#endregion
 //#region src/turbopack.ts
+init_helpers();
 let browserLaunchScheduled = false;
 /**
 * Returns the Turbopack rules config for dev-inspector.
@@ -647,8 +664,10 @@ function turbopackDevInspector(options = {}) {
 	} catch {
 		loaderPath = "./loader.js";
 	}
-	if (!(options.enabled ?? process.env.NODE_ENV !== "production")) return {};
-	if (options.autoOpenBrowser && !browserLaunchScheduled && typeof process !== "undefined" && process.env.NODE_ENV !== "production") {
+	const enabled = options.enabled ?? process.env.NODE_ENV !== "production";
+	const chromeDisabled = isChromeDisabled(options.disableChrome);
+	if (!enabled) return {};
+	if (options.autoOpenBrowser && !chromeDisabled && !browserLaunchScheduled && typeof process !== "undefined" && process.env.NODE_ENV !== "production") {
 		browserLaunchScheduled = true;
 		const { launchBrowserWithDevTools: launchBrowserWithDevTools$1 } = (init_browser_launcher(), __toCommonJS(browser_launcher_exports));
 		const host = options.host || "localhost";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpc-tech/unplugin-dev-inspector-mcp",
-  "version": "0.0.42-beta.2",
+  "version": "0.0.42-beta.4",
   "description": "Universal dev inspector plugin for React/Vue - inspect component sources and API calls in any bundler",
   "type": "module",
   "license": "MIT",