chrome-devtools-mcp 0.2.2 → 0.2.4

package/README.md

@@ -66,6 +66,17 @@ claude mcp add chrome-devtools npx chrome-devtools-mcp@latest
   Follow https://docs.cline.bot/mcp/configuring-mcp-servers and use the config provided above.
 </details>
 
+<details>
+  <summary>Codex</summary>
+  Follow the <a href="https://github.com/openai/codex/blob/main/docs/advanced.md#model-context-protocol-mcp">configure MCP guide</a>
+  using the standard config from above. You can also install the Chrome DevTools MCP server using the Codex CLI:
+
+```bash
+codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest
+```
+
+</details>
+
 <details>
   <summary>Copilot / VS Code</summary>
   Follow the MCP install <a href="https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server">guide</a>,
@@ -101,6 +112,19 @@ Go to `Cursor Settings` -> `MCP` -> `New MCP Server`. Use the config provided ab
   using the standard config from above.
 </details>
 
+### Your first prompt
+
+Enter the following prompt in your MCP Client to check if everything is working:
+
+```
+Check the performance of https://developers.chrome.com
+```
+
+Your MCP client should open the browser and record a performance trace.
+
+> [!NOTE]  
+> The MCP server will start the browser automatically once the MCP client uses a tool that requires a running browser instance. Connecting to the Chrome DevTools MCP server on its own will not automatically start the browser.
+
 ## Tools
 
 <!-- BEGIN AUTO GENERATED TOOLS -->

package/build/src/McpContext.js

@@ -80,6 +80,14 @@ export class McpContext {
         this.#consoleCollector.addPage(page);
         return page;
     }
+    async closePage(pageIdx) {
+        if (this.#pages.length === 1) {
+            throw new Error('Unable to close the last page in the browser. It is fine to keep the last page open.');
+        }
+        const page = this.getPageByIdx(pageIdx);
+        this.setSelectedPageIdx(0);
+        await page.close({ runBeforeUnload: false });
+    }
     getNetworkRequestByUrl(url) {
         const requests = this.getNetworkRequests();
         if (!requests.length) {

package/build/src/McpResponse.js

@@ -123,7 +123,12 @@ Call browser_handle_dialog to handle it before continuing.`);
         }
         if (this.#includeConsoleData && this.#formattedConsoleData) {
             response.push('## Console messages');
-            response.push(...this.#formattedConsoleData);
+            if (this.#formattedConsoleData.length) {
+                response.push(...this.#formattedConsoleData);
+            }
+            else {
+                response.push('<no console messages found>');
+            }
         }
         const text = {
             type: 'text',

package/build/src/WaitForHelper.js

@@ -110,7 +110,14 @@ export class WaitForHelper {
             return;
         })
             .catch(error => logger(error));
-        await action();
+        try {
+            await action();
+        }
+        catch (error) {
+            // Clear up pending promises
+            this.#abortController.abort();
+            throw error;
+        }
         try {
             await navigationFinished;
             // Wait for stable dom after navigation so we execute in

package/build/src/tools/pages.js

@@ -39,7 +39,7 @@ export const selectPage = defineTool({
 });
 export const closePage = defineTool({
     name: 'close_page',
-    description: `Closes the page by its index.`,
+    description: `Closes the page by its index. The last open page cannot be closed.`,
     annotations: {
         category: ToolCategories.NAVIGATION_AUTOMATION,
         readOnlyHint: false,
@@ -50,9 +50,7 @@ export const closePage = defineTool({
             .describe('The index of the page to close. Call list_pages to list pages.'),
     },
     handler: async (request, response, context) => {
-        const page = context.getPageByIdx(request.params.pageIdx);
-        context.setSelectedPageIdx(0);
-        await page.close({ runBeforeUnload: false });
+        await context.closePage(request.params.pageIdx);
         response.setIncludePages(true);
     },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",