@mcpc-tech/unplugin-dev-inspector-mcp 0.0.2-beta.29 → 0.0.2-beta.30

package/dist/index.cjs

@@ -86462,16 +86462,16 @@ const PROMPT_SCHEMAS = {
 			required: true
 		}]
 	},
-	refresh_chrome_state: {
-		name: "refresh_chrome_state",
-		title: "Refresh Chrome State",
-		description: "Refresh the state of the Chrome DevTools for the specified URL.",
-		arguments: []
-	},
 	get_network_requests: {
 		name: "get_network_requests",
 		title: "Get Network Requests",
-		description: "Get all network requests for the specified URL.",
+		description: "List network requests or get details of a specific one. Always refreshes the list first.",
+		arguments: []
+	},
+	get_console_messages: {
+		name: "get_console_messages",
+		title: "Get Console Messages",
+		description: "List console messages or get details of a specific one. Always refreshes the list first.",
 		arguments: []
 	}
 };
@@ -86627,7 +86627,7 @@ async function createInspectorMcpServer(serverContext) {
 
 Provides tools for inspecting network requests, console logs, and performance metrics.
 
-IMPORTANT: Must first call chrome_navigate_page to launch Chrome before using these capabilities.
+If Chrome is already open, this tool can connect to it directly. Otherwise, call chrome_navigate_page first to launch Chrome.
 Default dev server URL: http://${serverContext?.host || "localhost"}:${serverContext?.port || 5173}
 
 You MUST ask the user for confirmation before navigating to any URL.`,
@@ -86685,9 +86685,66 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 					required: false
 				}]
 			},
-			{ ...PROMPT_SCHEMAS.refresh_chrome_state }
+			{ ...PROMPT_SCHEMAS.get_network_requests },
+			{ ...PROMPT_SCHEMAS.get_console_messages }
 		] };
 	});
+	async function refreshChromeState() {
+		const networkResult = await callMcpMethod(mcpServer, "tools/call", {
+			name: "chrome_devtools",
+			arguments: {
+				useTool: "chrome_list_network_requests",
+				hasDefinitions: ["chrome_list_network_requests"],
+				chrome_list_network_requests: {}
+			}
+		});
+		const consoleResult = await callMcpMethod(mcpServer, "tools/call", {
+			name: "chrome_devtools",
+			arguments: {
+				useTool: "chrome_list_console_messages",
+				hasDefinitions: ["chrome_list_console_messages"],
+				chrome_list_console_messages: {}
+			}
+		});
+		const reqIdMatches = (networkResult?.content?.map((item) => item.text).join("\n") || "").matchAll(/reqid=(\d+)\s+(GET|POST|PUT|DELETE|PATCH)\s+([^\s]+)\s+\[([^\]]+)\]/g);
+		const requestOptions = Array.from(reqIdMatches).map((match) => {
+			const [, reqId, method, url$1, status] = match;
+			return `  ${reqId}: ${method} ${url$1.length > 60 ? url$1.substring(0, 57) + "..." : url$1} [${status}]`;
+		}).reverse().join("\n");
+		const msgIdMatches = (consoleResult?.content?.map((item) => item.text).join("\n") || "").matchAll(/msgid=(\d+)\s+\[([^\]]+)\]\s+(.+)/g);
+		const messageOptions = Array.from(msgIdMatches).map((match) => {
+			const [, msgId, level, text$2] = match;
+			return `  ${msgId}: [${level}] ${text$2.length > 60 ? text$2.substring(0, 57) + "..." : text$2}`;
+		}).reverse().join("\n");
+		mcpServer.setRequestHandler(__modelcontextprotocol_sdk_types_js.ListPromptsRequestSchema, async (request$1) => {
+			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
+					}]
+				}
+			] };
+		});
+		await mcpServer.sendPromptListChanged();
+		return { messages: [...networkResult?.content || [], ...consoleResult?.content || []].map((item) => ({
+			role: "user",
+			content: item
+		})) };
+	}
 	mcpServer.setRequestHandler(__modelcontextprotocol_sdk_types_js.GetPromptRequestSchema, async (request$1) => {
 		const promptName = request$1.params.name;
 		switch (promptName) {
@@ -86720,14 +86777,16 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 					}] };
 				}
 				try {
-					return { messages: [...((await callMcpMethod(mcpServer, "tools/call", {
+					const result = await callMcpMethod(mcpServer, "tools/call", {
 						name: "chrome_devtools",
 						arguments: {
 							useTool: "chrome_navigate_page",
 							hasDefinitions: ["chrome_navigate_page"],
 							chrome_navigate_page: { url: url$1 }
 						}
-					}))?.content || []).map((item) => ({
+					});
+					await refreshChromeState();
+					return { messages: [...(result?.content || []).map((item) => ({
 						role: "user",
 						content: item
 					}))] };
@@ -86741,52 +86800,11 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 					}] };
 				}
 			}
-			case "refresh_chrome_state": try {
-				const result = await callMcpMethod(mcpServer, "tools/call", {
-					name: "chrome_devtools",
-					arguments: {
-						useTool: "chrome_list_network_requests",
-						hasDefinitions: ["chrome_list_network_requests"],
-						chrome_list_network_requests: {}
-					}
-				});
-				const reqIdMatches = (result?.content?.map((item) => item.text).join("\n") || "").matchAll(/reqid=(\d+)\s+(GET|POST|PUT|DELETE|PATCH)\s+([^\s]+)\s+\[([^\]]+)\]/g);
-				const requestOptions = Array.from(reqIdMatches).map((match) => {
-					const [, reqId, method, url$1, status] = match;
-					return `  ${reqId}: ${method} ${url$1.length > 60 ? url$1.substring(0, 57) + "..." : url$1} [${status}]`;
-				}).reverse().join("\n");
-				mcpServer.setRequestHandler(__modelcontextprotocol_sdk_types_js.ListPromptsRequestSchema, async (request$2) => {
-					return { prompts: [
-						{ ...PROMPT_SCHEMAS.capture_element },
-						{ ...PROMPT_SCHEMAS.view_inspections },
-						{ ...PROMPT_SCHEMAS.launch_chrome_devtools },
-						{ ...PROMPT_SCHEMAS.refresh_chrome_state },
-						{
-							...PROMPT_SCHEMAS.get_network_requests,
-							arguments: [{
-								name: "reqid",
-								description: `The request ID to get details for. Available requests:\n\n${requestOptions || "No requests available"}`,
-								required: true
-							}]
-						}
-					] };
-				});
-				await mcpServer.sendPromptListChanged();
-				return { messages: [...(result?.content || []).map((item) => ({
-					role: "user",
-					content: item
-				}))] };
-			} catch (error$1) {
-				return { messages: [{
-					role: "user",
-					content: {
-						type: "text",
-						text: `Error launching Chrome DevTools: ${error$1 instanceof Error ? error$1.message : String(error$1)}`
-					}
-				}] };
-			}
-			case "get_network_requests":
-				const reqid = parseInt(request$1.params.arguments?.reqid);
+			case "get_network_requests": {
+				const refreshResult = await refreshChromeState();
+				const reqidStr = request$1.params.arguments?.reqid;
+				if (!reqidStr) return refreshResult;
+				const reqid = parseInt(reqidStr);
 				try {
 					return { messages: [...((await callMcpMethod(mcpServer, "tools/call", {
 						name: "chrome_devtools",
@@ -86804,10 +86822,38 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 						role: "user",
 						content: {
 							type: "text",
-							text: `Error launching Chrome DevTools: ${error$1 instanceof Error ? error$1.message : String(error$1)}`
+							text: `Error getting network request: ${error$1 instanceof Error ? error$1.message : String(error$1)}`
 						}
 					}] };
 				}
+			}
+			case "get_console_messages": {
+				const refreshResultConsole = await refreshChromeState();
+				const msgidStr = request$1.params.arguments?.msgid;
+				if (!msgidStr) return refreshResultConsole;
+				const msgid = parseInt(msgidStr);
+				try {
+					return { messages: [...((await callMcpMethod(mcpServer, "tools/call", {
+						name: "chrome_devtools",
+						arguments: {
+							useTool: "chrome_get_console_message",
+							hasDefinitions: ["chrome_get_console_message"],
+							chrome_get_console_message: { msgid }
+						}
+					}))?.content || []).map((item) => ({
+						role: "user",
+						content: item
+					}))] };
+				} catch (error$1) {
+					return { messages: [{
+						role: "user",
+						content: {
+							type: "text",
+							text: `Error getting console message: ${error$1 instanceof Error ? error$1.message : String(error$1)}`
+						}
+					}] };
+				}
+			}
 			default: throw new Error(`Unknown promptId: ${promptName}`);
 		}
 	});
@@ -88214,10 +88260,10 @@ if (import.meta.env.DEV) {
 			},
 			async configureServer(server) {
 				if (enableMcp) {
-					const host = server.config.server.host;
+					const viteHost = server.config.server.host;
 					const serverContext = {
-						host: typeof host === "string" ? host : host === true ? "0.0.0.0" : "localhost",
-						port: server.config.server.port || 5173
+						host: options.host ?? (typeof viteHost === "string" ? viteHost : viteHost === true ? "0.0.0.0" : "localhost"),
+						port: options.port ?? server.config.server.port ?? 5173
 					};
 					const sseUrl = `http://${serverContext.host === "0.0.0.0" ? "localhost" : serverContext.host}:${serverContext.port}/__mcp__/sse?puppetId=chrome`;
 					console.log(`[dev-inspector] 📡 MCP: ${sseUrl}\n`);

package/dist/index.d.cts

@@ -71,7 +71,7 @@ interface Agent extends AcpOptions {
 interface DevInspectorOptions extends McpConfigOptions, AcpOptions {
   /**
    * Enable/disable the plugin
-   * @default true in development, false in production
+   * @default true (automatically disabled in production)
    */
   enabled?: boolean;
   /**
@@ -79,14 +79,30 @@ interface DevInspectorOptions extends McpConfigOptions, AcpOptions {
    * @default true
    */
   enableMcp?: boolean;
+  /**
+   * Custom host for MCP server URL
+   * Useful when behind a proxy or in Docker containers
+   * If not specified, uses the Vite server host config
+   * @example "localhost" or "my-dev-server.local"
+   */
+  host?: string;
+  /**
+   * Custom port for MCP server URL
+   * Useful when behind a proxy or port forwarding (e.g., Docker, SSH tunnels)
+   * If not specified, uses the Vite server port config
+   * @example 3000
+   */
+  port?: number;
   /**
    * Custom agents configuration
    * If provided, these will be merged with or replace the default agents
+   * @see AVAILABLE_AGENTS https://github.com/mcpc-tech/dev-inspector-mcp/blob/main/packages/unplugin-dev-inspector/client/constants/agents.ts
    */
   agents?: Agent[];
   /**
    * Default agent name to use
    * @default "Claude Code"
+   * @see https://github.com/mcpc-tech/dev-inspector-mcp/blob/main/packages/unplugin-dev-inspector/client/constants/agents.ts
    */
   defaultAgent?: string;
   /**

package/dist/index.d.ts

@@ -71,7 +71,7 @@ interface Agent extends AcpOptions {
 interface DevInspectorOptions extends McpConfigOptions, AcpOptions {
   /**
    * Enable/disable the plugin
-   * @default true in development, false in production
+   * @default true (automatically disabled in production)
    */
   enabled?: boolean;
   /**
@@ -79,14 +79,30 @@ interface DevInspectorOptions extends McpConfigOptions, AcpOptions {
    * @default true
    */
   enableMcp?: boolean;
+  /**
+   * Custom host for MCP server URL
+   * Useful when behind a proxy or in Docker containers
+   * If not specified, uses the Vite server host config
+   * @example "localhost" or "my-dev-server.local"
+   */
+  host?: string;
+  /**
+   * Custom port for MCP server URL
+   * Useful when behind a proxy or port forwarding (e.g., Docker, SSH tunnels)
+   * If not specified, uses the Vite server port config
+   * @example 3000
+   */
+  port?: number;
   /**
    * Custom agents configuration
    * If provided, these will be merged with or replace the default agents
+   * @see AVAILABLE_AGENTS https://github.com/mcpc-tech/dev-inspector-mcp/blob/main/packages/unplugin-dev-inspector/client/constants/agents.ts
    */
   agents?: Agent[];
   /**
    * Default agent name to use
    * @default "Claude Code"
+   * @see https://github.com/mcpc-tech/dev-inspector-mcp/blob/main/packages/unplugin-dev-inspector/client/constants/agents.ts
    */
   defaultAgent?: string;
   /**

package/dist/index.js

@@ -86454,16 +86454,16 @@ const PROMPT_SCHEMAS = {
 			required: true
 		}]
 	},
-	refresh_chrome_state: {
-		name: "refresh_chrome_state",
-		title: "Refresh Chrome State",
-		description: "Refresh the state of the Chrome DevTools for the specified URL.",
-		arguments: []
-	},
 	get_network_requests: {
 		name: "get_network_requests",
 		title: "Get Network Requests",
-		description: "Get all network requests for the specified URL.",
+		description: "List network requests or get details of a specific one. Always refreshes the list first.",
+		arguments: []
+	},
+	get_console_messages: {
+		name: "get_console_messages",
+		title: "Get Console Messages",
+		description: "List console messages or get details of a specific one. Always refreshes the list first.",
 		arguments: []
 	}
 };
@@ -86619,7 +86619,7 @@ async function createInspectorMcpServer(serverContext) {
 
 Provides tools for inspecting network requests, console logs, and performance metrics.
 
-IMPORTANT: Must first call chrome_navigate_page to launch Chrome before using these capabilities.
+If Chrome is already open, this tool can connect to it directly. Otherwise, call chrome_navigate_page first to launch Chrome.
 Default dev server URL: http://${serverContext?.host || "localhost"}:${serverContext?.port || 5173}
 
 You MUST ask the user for confirmation before navigating to any URL.`,
@@ -86677,9 +86677,66 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 					required: false
 				}]
 			},
-			{ ...PROMPT_SCHEMAS.refresh_chrome_state }
+			{ ...PROMPT_SCHEMAS.get_network_requests },
+			{ ...PROMPT_SCHEMAS.get_console_messages }
 		] };
 	});
+	async function refreshChromeState() {
+		const networkResult = await callMcpMethod(mcpServer, "tools/call", {
+			name: "chrome_devtools",
+			arguments: {
+				useTool: "chrome_list_network_requests",
+				hasDefinitions: ["chrome_list_network_requests"],
+				chrome_list_network_requests: {}
+			}
+		});
+		const consoleResult = await callMcpMethod(mcpServer, "tools/call", {
+			name: "chrome_devtools",
+			arguments: {
+				useTool: "chrome_list_console_messages",
+				hasDefinitions: ["chrome_list_console_messages"],
+				chrome_list_console_messages: {}
+			}
+		});
+		const reqIdMatches = (networkResult?.content?.map((item) => item.text).join("\n") || "").matchAll(/reqid=(\d+)\s+(GET|POST|PUT|DELETE|PATCH)\s+([^\s]+)\s+\[([^\]]+)\]/g);
+		const requestOptions = Array.from(reqIdMatches).map((match) => {
+			const [, reqId, method, url, status] = match;
+			return `  ${reqId}: ${method} ${url.length > 60 ? url.substring(0, 57) + "..." : url} [${status}]`;
+		}).reverse().join("\n");
+		const msgIdMatches = (consoleResult?.content?.map((item) => item.text).join("\n") || "").matchAll(/msgid=(\d+)\s+\[([^\]]+)\]\s+(.+)/g);
+		const messageOptions = Array.from(msgIdMatches).map((match) => {
+			const [, msgId, level, text$2] = match;
+			return `  ${msgId}: [${level}] ${text$2.length > 60 ? text$2.substring(0, 57) + "..." : text$2}`;
+		}).reverse().join("\n");
+		mcpServer.setRequestHandler(ListPromptsRequestSchema, async (request$1) => {
+			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
+					}]
+				}
+			] };
+		});
+		await mcpServer.sendPromptListChanged();
+		return { messages: [...networkResult?.content || [], ...consoleResult?.content || []].map((item) => ({
+			role: "user",
+			content: item
+		})) };
+	}
 	mcpServer.setRequestHandler(GetPromptRequestSchema, async (request$1) => {
 		const promptName = request$1.params.name;
 		switch (promptName) {
@@ -86712,14 +86769,16 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 					}] };
 				}
 				try {
-					return { messages: [...((await callMcpMethod(mcpServer, "tools/call", {
+					const result = await callMcpMethod(mcpServer, "tools/call", {
 						name: "chrome_devtools",
 						arguments: {
 							useTool: "chrome_navigate_page",
 							hasDefinitions: ["chrome_navigate_page"],
 							chrome_navigate_page: { url }
 						}
-					}))?.content || []).map((item) => ({
+					});
+					await refreshChromeState();
+					return { messages: [...(result?.content || []).map((item) => ({
 						role: "user",
 						content: item
 					}))] };
@@ -86733,52 +86792,11 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 					}] };
 				}
 			}
-			case "refresh_chrome_state": try {
-				const result = await callMcpMethod(mcpServer, "tools/call", {
-					name: "chrome_devtools",
-					arguments: {
-						useTool: "chrome_list_network_requests",
-						hasDefinitions: ["chrome_list_network_requests"],
-						chrome_list_network_requests: {}
-					}
-				});
-				const reqIdMatches = (result?.content?.map((item) => item.text).join("\n") || "").matchAll(/reqid=(\d+)\s+(GET|POST|PUT|DELETE|PATCH)\s+([^\s]+)\s+\[([^\]]+)\]/g);
-				const requestOptions = Array.from(reqIdMatches).map((match) => {
-					const [, reqId, method, url, status] = match;
-					return `  ${reqId}: ${method} ${url.length > 60 ? url.substring(0, 57) + "..." : url} [${status}]`;
-				}).reverse().join("\n");
-				mcpServer.setRequestHandler(ListPromptsRequestSchema, async (request$2) => {
-					return { prompts: [
-						{ ...PROMPT_SCHEMAS.capture_element },
-						{ ...PROMPT_SCHEMAS.view_inspections },
-						{ ...PROMPT_SCHEMAS.launch_chrome_devtools },
-						{ ...PROMPT_SCHEMAS.refresh_chrome_state },
-						{
-							...PROMPT_SCHEMAS.get_network_requests,
-							arguments: [{
-								name: "reqid",
-								description: `The request ID to get details for. Available requests:\n\n${requestOptions || "No requests available"}`,
-								required: true
-							}]
-						}
-					] };
-				});
-				await mcpServer.sendPromptListChanged();
-				return { messages: [...(result?.content || []).map((item) => ({
-					role: "user",
-					content: item
-				}))] };
-			} catch (error$1) {
-				return { messages: [{
-					role: "user",
-					content: {
-						type: "text",
-						text: `Error launching Chrome DevTools: ${error$1 instanceof Error ? error$1.message : String(error$1)}`
-					}
-				}] };
-			}
-			case "get_network_requests":
-				const reqid = parseInt(request$1.params.arguments?.reqid);
+			case "get_network_requests": {
+				const refreshResult = await refreshChromeState();
+				const reqidStr = request$1.params.arguments?.reqid;
+				if (!reqidStr) return refreshResult;
+				const reqid = parseInt(reqidStr);
 				try {
 					return { messages: [...((await callMcpMethod(mcpServer, "tools/call", {
 						name: "chrome_devtools",
@@ -86796,10 +86814,38 @@ You MUST ask the user for confirmation before navigating to any URL.`,
 						role: "user",
 						content: {
 							type: "text",
-							text: `Error launching Chrome DevTools: ${error$1 instanceof Error ? error$1.message : String(error$1)}`
+							text: `Error getting network request: ${error$1 instanceof Error ? error$1.message : String(error$1)}`
 						}
 					}] };
 				}
+			}
+			case "get_console_messages": {
+				const refreshResultConsole = await refreshChromeState();
+				const msgidStr = request$1.params.arguments?.msgid;
+				if (!msgidStr) return refreshResultConsole;
+				const msgid = parseInt(msgidStr);
+				try {
+					return { messages: [...((await callMcpMethod(mcpServer, "tools/call", {
+						name: "chrome_devtools",
+						arguments: {
+							useTool: "chrome_get_console_message",
+							hasDefinitions: ["chrome_get_console_message"],
+							chrome_get_console_message: { msgid }
+						}
+					}))?.content || []).map((item) => ({
+						role: "user",
+						content: item
+					}))] };
+				} catch (error$1) {
+					return { messages: [{
+						role: "user",
+						content: {
+							type: "text",
+							text: `Error getting console message: ${error$1 instanceof Error ? error$1.message : String(error$1)}`
+						}
+					}] };
+				}
+			}
 			default: throw new Error(`Unknown promptId: ${promptName}`);
 		}
 	});
@@ -88206,10 +88252,10 @@ if (import.meta.env.DEV) {
 			},
 			async configureServer(server) {
 				if (enableMcp) {
-					const host = server.config.server.host;
+					const viteHost = server.config.server.host;
 					const serverContext = {
-						host: typeof host === "string" ? host : host === true ? "0.0.0.0" : "localhost",
-						port: server.config.server.port || 5173
+						host: options.host ?? (typeof viteHost === "string" ? viteHost : viteHost === true ? "0.0.0.0" : "localhost"),
+						port: options.port ?? server.config.server.port ?? 5173
 					};
 					const sseUrl = `http://${serverContext.host === "0.0.0.0" ? "localhost" : serverContext.host}:${serverContext.port}/__mcp__/sse?puppetId=chrome`;
 					console.log(`[dev-inspector] 📡 MCP: ${sseUrl}\n`);

package/package.json

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