@mcp-b/chrome-devtools-mcp 1.0.2 → 1.0.3-beta.0

package/README.md

@@ -1,16 +1,31 @@
-# Chrome DevTools MCP
+# @mcp-b/chrome-devtools-mcp
+
+> MCP server for Chrome DevTools - Let Claude, Cursor, Copilot, and Gemini control and debug Chrome browser
 
 [![npm @mcp-b/chrome-devtools-mcp package](https://img.shields.io/npm/v/@mcp-b/chrome-devtools-mcp.svg)](https://www.npmjs.com/package/@mcp-b/chrome-devtools-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/@mcp-b/chrome-devtools-mcp?style=flat-square)](https://www.npmjs.com/package/@mcp-b/chrome-devtools-mcp)
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=flat-square)](https://opensource.org/licenses/Apache-2.0)
+[![28 Tools](https://img.shields.io/badge/MCP_Tools-28-green?style=flat-square)](./docs/tool-reference.md)
+[![Chrome](https://img.shields.io/badge/Chrome-DevTools-4285F4?style=flat-square&logo=googlechrome)](https://developer.chrome.com/docs/devtools/)
+
+📖 **[WebMCP Documentation](https://docs.mcp-b.ai)** | 🚀 **[Quick Start](https://docs.mcp-b.ai/quickstart)** | 🔌 **[Connecting Agents](https://docs.mcp-b.ai/connecting-agents)**
+
+**@mcp-b/chrome-devtools-mcp** lets AI coding agents like Claude, Gemini, Cursor, and Copilot control and inspect a live Chrome browser via the Model Context Protocol (MCP). Get performance insights, debug network requests, take screenshots, and interact with website-specific MCP tools through WebMCP integration.
 
 > **Note:** This is a fork of [ChromeDevTools/chrome-devtools-mcp](https://github.com/ChromeDevTools/chrome-devtools-mcp)
 > published under the `@mcp-b` scope. It includes WebMCP integration for connecting to MCP tools
 > registered on webpages. The original project is developed by Google LLC and the ChromeDevTools team.
 > See [NOTICE](./NOTICE) for attribution details.
 
-`@mcp-b/chrome-devtools-mcp` lets your coding agent (such as Gemini, Claude, Cursor or Copilot)
-control and inspect a live Chrome browser. It acts as a Model-Context-Protocol
-(MCP) server, giving your AI coding assistant access to the full power of
-Chrome DevTools for reliable automation, in-depth debugging, and performance analysis.
+## Why Use @mcp-b/chrome-devtools-mcp?
+
+| Feature | Benefit |
+|---------|---------|
+| **28 MCP Tools** | Comprehensive browser control - navigation, input, screenshots, performance, debugging |
+| **WebMCP Integration** | Connect to website-specific AI tools via `@mcp-b/global` |
+| **Performance Analysis** | Chrome DevTools-powered performance insights and trace recording |
+| **Reliable Automation** | Puppeteer-based with automatic waiting for action results |
+| **Works with All MCP Clients** | Claude, Cursor, Copilot, Gemini CLI, VS Code, Windsurf, and more |
 
 ## What's Different from Chrome DevTools MCP?
 
@@ -827,3 +842,22 @@ Call the website's form submission tool to fill out the contact form
   Use `list_webmcp_tools` to see the expected input format.
 - **Tools not appearing after navigation**: WebMCP auto-reconnects when you
   navigate. If the new page has different tools, call `list_webmcp_tools` again.
+
+## Related Packages
+
+- [`@mcp-b/global`](https://docs.mcp-b.ai/packages/global) - W3C Web Model Context API polyfill for websites
+- [`@mcp-b/transports`](https://docs.mcp-b.ai/packages/transports) - Browser-specific MCP transports
+- [`@mcp-b/react-webmcp`](https://docs.mcp-b.ai/packages/react-webmcp) - React hooks for MCP
+- [`@modelcontextprotocol/sdk`](https://www.npmjs.com/package/@modelcontextprotocol/sdk) - Official MCP SDK
+
+## Resources
+
+- [WebMCP Documentation](https://docs.mcp-b.ai)
+- [MCP-B Browser Extension](https://docs.mcp-b.ai/extension)
+- [Connecting Agents to WebMCP](https://docs.mcp-b.ai/connecting-agents)
+- [Model Context Protocol Spec](https://modelcontextprotocol.io)
+
+## Support
+
+- [GitHub Issues](https://github.com/WebMCP-org/npm-packages/issues)
+- [WebMCP Documentation](https://docs.mcp-b.ai)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mcp-b/chrome-devtools-mcp",
-  "version": "1.0.2",
-  "description": "MCP server for Chrome DevTools with WebMCP integration",
+  "version": "1.0.3-beta.0",
+  "description": "MCP server for Chrome DevTools with WebMCP integration for connecting to website MCP tools",
   "keywords": [
     "mcp",
     "model-context-protocol",
@@ -47,25 +47,6 @@
     "LICENSE",
     "!*.tsbuildinfo"
   ],
-  "scripts": {
-    "build": "tsc && node --experimental-strip-types --no-warnings=ExperimentalWarning scripts/post-build.ts",
-    "bundle": "npm run clean && npm run build && rollup -c rollup.config.mjs",
-    "check-format": "eslint --cache . && prettier --check --cache .;",
-    "clean": "node -e \"require('fs').rmSync('build', {recursive: true, force: true})\"",
-    "docs": "npm run build && npm run docs:generate && npm run format",
-    "docs:generate": "node --experimental-strip-types scripts/generate-docs.ts",
-    "format": "eslint --cache --fix . && prettier --write --cache .",
-    "prepare": "node --experimental-strip-types scripts/prepare.ts",
-    "start": "npm run build && node build/src/index.js",
-    "start-debug": "DEBUG=mcp:* DEBUG_COLORS=false npm run build && node build/src/index.js",
-    "test": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test \"build/tests/**/*.test.js\"",
-    "test:node20": "node --require ./build/tests/setup.js --test-reporter spec --test-force-exit --test build/tests",
-    "test:only": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test --test-only \"build/tests/**/*.test.js\"",
-    "test:only:no-build": "node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test --test-only \"build/tests/**/*.test.js\"",
-    "test:update-snapshots": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-force-exit --test --test-update-snapshots \"build/tests/**/*.test.js\"",
-    "typecheck": "tsc --noEmit",
-    "verify-server-json-version": "node --experimental-strip-types scripts/verify-server-json-version.ts"
-  },
   "devDependencies": {
     "@eslint/js": "^9.35.0",
     "@modelcontextprotocol/sdk": "1.24.1",
@@ -109,5 +90,23 @@
   "upstream": {
     "repository": "https://github.com/ChromeDevTools/chrome-devtools-mcp",
     "mcpName": "io.github.ChromeDevTools/chrome-devtools-mcp"
+  },
+  "scripts": {
+    "build": "tsc && node --experimental-strip-types --no-warnings=ExperimentalWarning scripts/post-build.ts",
+    "bundle": "npm run clean && npm run build && rollup -c rollup.config.mjs",
+    "check-format": "eslint --cache . && prettier --check --cache .;",
+    "clean": "node -e \"require('fs').rmSync('build', {recursive: true, force: true})\"",
+    "docs": "npm run build && npm run docs:generate && npm run format",
+    "docs:generate": "node --experimental-strip-types scripts/generate-docs.ts",
+    "format": "eslint --cache --fix . && prettier --write --cache .",
+    "start": "npm run build && node build/src/index.js",
+    "start-debug": "DEBUG=mcp:* DEBUG_COLORS=false npm run build && node build/src/index.js",
+    "test": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test \"build/tests/**/*.test.js\"",
+    "test:node20": "node --require ./build/tests/setup.js --test-reporter spec --test-force-exit --test build/tests",
+    "test:only": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test --test-only \"build/tests/**/*.test.js\"",
+    "test:only:no-build": "node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test --test-only \"build/tests/**/*.test.js\"",
+    "test:update-snapshots": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-force-exit --test --test-update-snapshots \"build/tests/**/*.test.js\"",
+    "typecheck": "tsc --noEmit",
+    "verify-server-json-version": "node --experimental-strip-types scripts/verify-server-json-version.ts"
   }
-}
+}

package/build/node_modules/chrome-devtools-frontend/LICENSE

@@ -1,27 +0,0 @@
-// Copyright 2014 The Chromium Authors
-//
-// Redistribution and use in source and binary forms, with or without
-// modification, are permitted provided that the following conditions are
-// met:
-//
-//    * Redistributions of source code must retain the above copyright
-// notice, this list of conditions and the following disclaimer.
-//    * Redistributions in binary form must reproduce the above
-// copyright notice, this list of conditions and the following disclaimer
-// in the documentation and/or other materials provided with the
-// distribution.
-//    * Neither the name of Google Inc. nor the names of its
-// contributors may be used to endorse or promote products derived from
-// this software without specific prior written permission.
-//
-// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/build/node_modules/chrome-devtools-frontend/front_end/core/common/App.js

@@ -1,4 +0,0 @@
-// Copyright 2019 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-export {};

package/build/node_modules/chrome-devtools-frontend/front_end/core/common/AppProvider.js

@@ -1,17 +0,0 @@
-// Copyright 2019 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-import * as Root from '../root/root.js';
-const registeredAppProvider = [];
-export function registerAppProvider(registration) {
-    registeredAppProvider.push(registration);
-}
-export function getRegisteredAppProviders() {
-    return registeredAppProvider
-        .filter(provider => Root.Runtime.Runtime.isDescriptorEnabled({ experiment: undefined, condition: provider.condition }))
-        .sort((firstProvider, secondProvider) => {
-        const order1 = firstProvider.order || 0;
-        const order2 = secondProvider.order || 0;
-        return order1 - order2;
-    });
-}

package/build/node_modules/chrome-devtools-frontend/front_end/core/common/Base64.js

@@ -1,43 +0,0 @@
-// Copyright 2020 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-export const BASE64_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
-export const BASE64_CODES = new Uint8Array(123);
-for (let index = 0; index < BASE64_CHARS.length; ++index) {
-    BASE64_CODES[BASE64_CHARS.charCodeAt(index)] = index;
-}
-/**
- * Decodes Base64-encoded data from a string without performing any kind of checking.
- */
-export function decode(input) {
-    let bytesLength = ((input.length * 3) / 4) >>> 0;
-    if (input.charCodeAt(input.length - 2) === 0x3d /* '=' */) {
-        bytesLength -= 2;
-    }
-    else if (input.charCodeAt(input.length - 1) === 0x3d /* '=' */) {
-        bytesLength -= 1;
-    }
-    const bytes = new Uint8Array(bytesLength);
-    for (let index = 0, offset = 0; index < input.length; index += 4) {
-        const a = BASE64_CODES[input.charCodeAt(index + 0)];
-        const b = BASE64_CODES[input.charCodeAt(index + 1)];
-        const c = BASE64_CODES[input.charCodeAt(index + 2)];
-        const d = BASE64_CODES[input.charCodeAt(index + 3)];
-        bytes[offset++] = (a << 2) | (b >> 4);
-        bytes[offset++] = ((b & 0x0f) << 4) | (c >> 2);
-        bytes[offset++] = ((c & 0x03) << 6) | (d & 0x3f);
-    }
-    return bytes;
-}
-export function encode(input) {
-    return new Promise((resolve, reject) => {
-        const reader = new FileReader();
-        reader.onerror = () => reject(new Error('failed to convert to base64'));
-        reader.onload = () => {
-            const blobAsUrl = reader.result;
-            const [, base64] = blobAsUrl.split(',', 2);
-            resolve(base64);
-        };
-        reader.readAsDataURL(new Blob([input]));
-    });
-}

package/build/node_modules/chrome-devtools-frontend/front_end/core/common/CharacterIdMap.js

@@ -1,27 +0,0 @@
-// Copyright 2016 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-export class CharacterIdMap {
-    #elementToCharacter = new Map();
-    #characterToElement = new Map();
-    #charCode = 33;
-    toChar(object) {
-        let character = this.#elementToCharacter.get(object);
-        if (!character) {
-            if (this.#charCode >= 0xFFFF) {
-                throw new Error('CharacterIdMap ran out of capacity!');
-            }
-            character = String.fromCharCode(this.#charCode++);
-            this.#elementToCharacter.set(object, character);
-            this.#characterToElement.set(character, object);
-        }
-        return character;
-    }
-    fromChar(character) {
-        const object = this.#characterToElement.get(character);
-        if (object === undefined) {
-            return null;
-        }
-        return object;
-    }
-}