chrome-devtools-mcp 0.2.6 → 0.2.7

package/README.md

@@ -27,7 +27,7 @@ MCP clients.
 
 ## Requirements
 
-- [Node.js 22](https://nodejs.org/) or newer.
+- [Node.js 22.12.0](https://nodejs.org/) or newer.
 - [Chrome](https://www.google.com/chrome/) current stable version or newer.
 - [npm](https://www.npmjs.com/).
 

package/build/src/index.js

@@ -4,202 +4,10 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { SetLevelRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import yargs from 'yargs';
-import { hideBin } from 'yargs/helpers';
-import { McpResponse } from './McpResponse.js';
-import { McpContext } from './McpContext.js';
-import { logger, saveLogsToFile } from './logger.js';
-import { resolveBrowser } from './browser.js';
-import * as emulationTools from './tools/emulation.js';
-import * as consoleTools from './tools/console.js';
-import * as inputTools from './tools/input.js';
-import * as networkTools from './tools/network.js';
-import * as pagesTools from './tools/pages.js';
-import * as performanceTools from './tools/performance.js';
-import * as screenshotTools from './tools/screenshot.js';
-import * as scriptTools from './tools/script.js';
-import * as snapshotTools from './tools/snapshot.js';
-import path from 'node:path';
-import fs from 'node:fs';
-import assert from 'node:assert';
-import { Mutex } from './Mutex.js';
-export const cliOptions = {
-    browserUrl: {
-        type: 'string',
-        description: 'Connect to a running Chrome instance using port forwarding. For more details see: https://developer.chrome.com/docs/devtools/remote-debugging/local-server.',
-        alias: 'u',
-        coerce: (url) => {
-            new URL(url);
-            return url;
-        },
-    },
-    headless: {
-        type: 'boolean',
-        description: 'Whether to run in headless (no UI) mode.',
-        default: false,
-    },
-    executablePath: {
-        type: 'string',
-        description: 'Path to custom Chrome executable.',
-        conflicts: 'browserUrl',
-        alias: 'e',
-    },
-    isolated: {
-        type: 'boolean',
-        description: 'If specified, creates a temporary user-data-dir that is automatically cleaned up after the browser is closed.',
-        default: false,
-    },
-    customDevtools: {
-        type: 'string',
-        description: 'Path to custom DevTools.',
-        hidden: true,
-        conflicts: 'browserUrl',
-        alias: 'd',
-    },
-    channel: {
-        type: 'string',
-        description: 'Specify a different Chrome channel that should be used. The default is the stable channel version.',
-        choices: ['stable', 'canary', 'beta', 'dev'],
-        conflicts: ['browserUrl', 'executablePath'],
-    },
-    logFile: {
-        type: 'string',
-        describe: 'Save the logs to file.',
-        hidden: true,
-    },
-};
-function readPackageJson() {
-    const currentDir = import.meta.dirname;
-    const packageJsonPath = path.join(currentDir, '..', '..', 'package.json');
-    if (!fs.existsSync(packageJsonPath)) {
-        return {};
-    }
-    try {
-        const json = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-        assert.strict(json['name'], 'chrome-devtools-mcp');
-        return json;
-    }
-    catch {
-        return {};
-    }
+const [major, minor] = process.version.substring(1).split('.').map(Number);
+if (major < 22 || (major === 22 && minor < 12)) {
+    console.error(`ERROR: \`chrome-devtools-mcp\` does not support Node ${process.version}. Please upgrade to Node 22+.`);
+    process.exit(1);
 }
-const version = readPackageJson().version ?? 'unknown';
-const yargsInstance = yargs(hideBin(process.argv))
-    .scriptName('npx chrome-devtools-mcp@latest')
-    .options(cliOptions)
-    .check(args => {
-    // We can't set default in the options else
-    // Yargs will complain
-    if (!args.channel && !args.browserUrl) {
-        args.channel = 'stable';
-    }
-    return true;
-})
-    .example([
-    [
-        '$0 --browserUrl http://127.0.0.1:9222',
-        'Connect to an existing browser instance',
-    ],
-    ['$0 --channel beta', 'Use Chrome Beta installed on this system'],
-    ['$0 --channel canary', 'Use Chrome Canary installed on this system'],
-    ['$0 --channel dev', 'Use Chrome Dev installed on this system'],
-    ['$0 --channel stable', 'Use stable Chrome installed on this system'],
-    ['$0 --logFile /tmp/log.txt', 'Save logs to a file'],
-    ['$0 --help', 'Print CLI options'],
-]);
-export const args = yargsInstance
-    .wrap(Math.min(120, yargsInstance.terminalWidth()))
-    .help()
-    .version(version)
-    .parseSync();
-const logFile = args.logFile ? saveLogsToFile(args.logFile) : undefined;
-logger(`Starting Chrome DevTools MCP Server v${version}`);
-const server = new McpServer({
-    name: 'chrome_devtools',
-    title: 'Chrome DevTools MCP server',
-    version,
-}, { capabilities: { logging: {} } });
-server.server.setRequestHandler(SetLevelRequestSchema, () => {
-    return {};
-});
-let context;
-async function getContext() {
-    const browser = await resolveBrowser({
-        browserUrl: args.browserUrl,
-        headless: args.headless,
-        executablePath: args.executablePath,
-        customDevTools: args.customDevtools,
-        channel: args.channel,
-        isolated: args.isolated,
-        logFile,
-    });
-    if (context?.browser !== browser) {
-        context = await McpContext.from(browser, logger);
-    }
-    return context;
-}
-const logDisclaimers = () => {
-    console.error(`chrome-devtools-mcp exposes content of the browser instance to the MCP clients allowing them to inspect,
-debug, and modify any data in the browser or DevTools.
-Avoid sharing sensitive or personal information that you do want to share with MCP clients.`);
-};
-const toolMutex = new Mutex();
-function registerTool(tool) {
-    server.registerTool(tool.name, {
-        description: tool.description,
-        inputSchema: tool.schema,
-        annotations: tool.annotations,
-    }, async (params) => {
-        const guard = await toolMutex.acquire();
-        try {
-            logger(`${tool.name} request: ${JSON.stringify(params, null, '  ')}`);
-            const context = await getContext();
-            const response = new McpResponse();
-            await tool.handler({
-                params,
-            }, response, context);
-            try {
-                const content = await response.handle(tool.name, context);
-                return {
-                    content,
-                };
-            }
-            catch (error) {
-                const errorText = error instanceof Error ? error.message : String(error);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: errorText,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        }
-        finally {
-            guard.dispose();
-        }
-    });
-}
-const tools = [
-    ...Object.values(consoleTools),
-    ...Object.values(emulationTools),
-    ...Object.values(inputTools),
-    ...Object.values(networkTools),
-    ...Object.values(pagesTools),
-    ...Object.values(performanceTools),
-    ...Object.values(screenshotTools),
-    ...Object.values(scriptTools),
-    ...Object.values(snapshotTools),
-];
-for (const tool of tools) {
-    registerTool(tool);
-}
-const transport = new StdioServerTransport();
-await server.connect(transport);
-logger('Chrome DevTools MCP Server connected');
-logDisclaimers();
+await import('./main.js');
+export {};

package/build/src/main.js

@@ -0,0 +1,204 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { SetLevelRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import yargs from 'yargs';
+import { hideBin } from 'yargs/helpers';
+import { McpResponse } from './McpResponse.js';
+import { McpContext } from './McpContext.js';
+import { logger, saveLogsToFile } from './logger.js';
+import { resolveBrowser } from './browser.js';
+import * as emulationTools from './tools/emulation.js';
+import * as consoleTools from './tools/console.js';
+import * as inputTools from './tools/input.js';
+import * as networkTools from './tools/network.js';
+import * as pagesTools from './tools/pages.js';
+import * as performanceTools from './tools/performance.js';
+import * as screenshotTools from './tools/screenshot.js';
+import * as scriptTools from './tools/script.js';
+import * as snapshotTools from './tools/snapshot.js';
+import path from 'node:path';
+import fs from 'node:fs';
+import assert from 'node:assert';
+import { Mutex } from './Mutex.js';
+export const cliOptions = {
+    browserUrl: {
+        type: 'string',
+        description: 'Connect to a running Chrome instance using port forwarding. For more details see: https://developer.chrome.com/docs/devtools/remote-debugging/local-server.',
+        alias: 'u',
+        coerce: (url) => {
+            new URL(url);
+            return url;
+        },
+    },
+    headless: {
+        type: 'boolean',
+        description: 'Whether to run in headless (no UI) mode.',
+        default: false,
+    },
+    executablePath: {
+        type: 'string',
+        description: 'Path to custom Chrome executable.',
+        conflicts: 'browserUrl',
+        alias: 'e',
+    },
+    isolated: {
+        type: 'boolean',
+        description: 'If specified, creates a temporary user-data-dir that is automatically cleaned up after the browser is closed.',
+        default: false,
+    },
+    customDevtools: {
+        type: 'string',
+        description: 'Path to custom DevTools.',
+        hidden: true,
+        conflicts: 'browserUrl',
+        alias: 'd',
+    },
+    channel: {
+        type: 'string',
+        description: 'Specify a different Chrome channel that should be used. The default is the stable channel version.',
+        choices: ['stable', 'canary', 'beta', 'dev'],
+        conflicts: ['browserUrl', 'executablePath'],
+    },
+    logFile: {
+        type: 'string',
+        describe: 'Save the logs to file.',
+        hidden: true,
+    },
+};
+function readPackageJson() {
+    const currentDir = import.meta.dirname;
+    const packageJsonPath = path.join(currentDir, '..', '..', 'package.json');
+    if (!fs.existsSync(packageJsonPath)) {
+        return {};
+    }
+    try {
+        const json = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+        assert.strict(json['name'], 'chrome-devtools-mcp');
+        return json;
+    }
+    catch {
+        return {};
+    }
+}
+const version = readPackageJson().version ?? 'unknown';
+const yargsInstance = yargs(hideBin(process.argv))
+    .scriptName('npx chrome-devtools-mcp@latest')
+    .options(cliOptions)
+    .check(args => {
+    // We can't set default in the options else
+    // Yargs will complain
+    if (!args.channel && !args.browserUrl) {
+        args.channel = 'stable';
+    }
+    return true;
+})
+    .example([
+    [
+        '$0 --browserUrl http://127.0.0.1:9222',
+        'Connect to an existing browser instance',
+    ],
+    ['$0 --channel beta', 'Use Chrome Beta installed on this system'],
+    ['$0 --channel canary', 'Use Chrome Canary installed on this system'],
+    ['$0 --channel dev', 'Use Chrome Dev installed on this system'],
+    ['$0 --channel stable', 'Use stable Chrome installed on this system'],
+    ['$0 --logFile /tmp/log.txt', 'Save logs to a file'],
+    ['$0 --help', 'Print CLI options'],
+]);
+export const args = yargsInstance
+    .wrap(Math.min(120, yargsInstance.terminalWidth()))
+    .help()
+    .version(version)
+    .parseSync();
+const logFile = args.logFile ? saveLogsToFile(args.logFile) : undefined;
+logger(`Starting Chrome DevTools MCP Server v${version}`);
+const server = new McpServer({
+    name: 'chrome_devtools',
+    title: 'Chrome DevTools MCP server',
+    version,
+}, { capabilities: { logging: {} } });
+server.server.setRequestHandler(SetLevelRequestSchema, () => {
+    return {};
+});
+let context;
+async function getContext() {
+    const browser = await resolveBrowser({
+        browserUrl: args.browserUrl,
+        headless: args.headless,
+        executablePath: args.executablePath,
+        customDevTools: args.customDevtools,
+        channel: args.channel,
+        isolated: args.isolated,
+        logFile,
+    });
+    if (context?.browser !== browser) {
+        context = await McpContext.from(browser, logger);
+    }
+    return context;
+}
+const logDisclaimers = () => {
+    console.error(`chrome-devtools-mcp exposes content of the browser instance to the MCP clients allowing them to inspect,
+debug, and modify any data in the browser or DevTools.
+Avoid sharing sensitive or personal information that you do want to share with MCP clients.`);
+};
+const toolMutex = new Mutex();
+function registerTool(tool) {
+    server.registerTool(tool.name, {
+        description: tool.description,
+        inputSchema: tool.schema,
+        annotations: tool.annotations,
+    }, async (params) => {
+        const guard = await toolMutex.acquire();
+        try {
+            logger(`${tool.name} request: ${JSON.stringify(params, null, '  ')}`);
+            const context = await getContext();
+            const response = new McpResponse();
+            await tool.handler({
+                params,
+            }, response, context);
+            try {
+                const content = await response.handle(tool.name, context);
+                return {
+                    content,
+                };
+            }
+            catch (error) {
+                const errorText = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: errorText,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        finally {
+            guard.dispose();
+        }
+    });
+}
+const tools = [
+    ...Object.values(consoleTools),
+    ...Object.values(emulationTools),
+    ...Object.values(inputTools),
+    ...Object.values(networkTools),
+    ...Object.values(pagesTools),
+    ...Object.values(performanceTools),
+    ...Object.values(screenshotTools),
+    ...Object.values(scriptTools),
+    ...Object.values(snapshotTools),
+];
+for (const tool of tools) {
+    registerTool(tool);
+}
+const transport = new StdioServerTransport();
+await server.connect(transport);
+logger('Chrome DevTools MCP Server connected');
+logDisclaimers();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",
@@ -58,5 +58,8 @@
     "sinon": "^21.0.0",
     "typescript": "^5.9.2",
     "typescript-eslint": "^8.43.0"
+  },
+  "engines": {
+    "node": ">=22.12.0"
   }
 }