feat: Add Microsoft Edge support

Author: david-risney

README.md

@@ -508,6 +508,12 @@ The Chrome DevTools MCP server supports the following configuration option:
   - **Type:** string
   - **Choices:** `stable`, `canary`, `beta`, `dev`
 
+- **`--browser`**
+  Specify which browser to use. Defaults to Chrome.
+  - **Type:** string
+  - **Choices:** `chrome`, `edge`
+  - **Default:** `chrome`
+
 - **`--logFile`/ `--log-file`**
   Path to a file to write debug logs to. Set the env variable `DEBUG` to `*` to enable verbose logs. Useful for submitting bug reports.
   - **Type:** string
@@ -750,6 +756,95 @@ For more details on remote debugging, see the [Chrome DevTools documentation](ht
 
 Please consult [these instructions](./docs/debugging-android.md).
 
+### Additional browser support
+
+In addition to Chrome, Chrome DevTools MCP supports Microsoft Edge. Edge must be installed separately. It is not bundled or downloaded by the MCP server.
+
+#### Microsoft Edge
+
+Pass `--browser=edge` to use the Microsoft Edge browser:
+
+```json
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest", "--browser=edge"]
+    }
+  }
+}
+```
+
+You can combine `--browser=edge` with other flags such as `--channel`, `--headless`, `--autoConnect`, and `--executablePath`.
+
+#### Edge channels
+
+Edge supports `stable`, `beta`, `dev`, and `canary` channels selected via `--channel`.
+
+```bash
+npx chrome-devtools-mcp@latest --browser=edge --channel=beta
+```
+
+#### Edge executable paths
+
+The MCP server automatically detects Edge installations in the standard locations:
+
+| Platform | Stable channel path |
+|----------|-------------|
+| **Windows** | `C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe` |
+| **macOS** | `/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge` |
+| **Linux** | `/opt/microsoft/msedge/msedge` or `/usr/bin/microsoft-edge` |
+
+If Edge is installed in a non-standard location, use `--executablePath` to specify the path manually.
+
+#### Edge user data directory
+
+When using `--browser=edge`, the user data directory pattern changes from `chrome-profile-$CHANNEL` to `edge-profile-$CHANNEL`:
+
+- Linux / macOS: `$HOME/.cache/chrome-devtools-mcp/edge-profile-$CHANNEL`
+- Windows: `%HOMEPATH%/.cache/chrome-devtools-mcp/edge-profile-$CHANNEL`
+
+#### Auto-connecting to a running Edge instance
+
+Use `--autoConnect` with `--browser=edge` to connect to an already-running Edge instance:
+
+```json
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest", "--autoConnect", "--browser=edge"]
+    }
+  }
+}
+```
+
+Before connecting, enable remote debugging in Edge by navigating to `edge://inspect/#remote-debugging`.
+
+#### Manual connection to a running Edge instance
+
+Edge uses the same remote debugging protocol as Chrome. Start Edge with a remote debugging port and connect via `--browser-url`:
+
+**Windows**
+
+```bash
+"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --remote-debugging-port=9222 --user-data-dir="%TEMP%\edge-profile-stable"
+```
+
+**macOS**
+
+```bash
+/Applications/Microsoft\ Edge.app/Contents/MacOS/Microsoft\ Edge --remote-debugging-port=9222 --user-data-dir=/tmp/edge-profile-stable
+```
+
+**Linux**
+
+```bash
+/opt/microsoft/msedge/msedge --remote-debugging-port=9222 --user-data-dir=/tmp/edge-profile-stable
+```
+
+Then configure the MCP server with `--browser-url=http://127.0.0.1:9222`.
+
 ## Known limitations
 
 See [Troubleshooting](./docs/troubleshooting.md).

skills/chrome-devtools/SKILL.md

@@ -5,7 +5,9 @@ description: Uses Chrome DevTools via MCP for efficient debugging, troubleshooti
 
 ## Core Concepts
 
-**Browser lifecycle**: Browser starts automatically on first tool call using a persistent Chrome profile. Configure via CLI args in the MCP server configuration: `npx chrome-devtools-mcp@latest --help`.
+**Browser lifecycle**: Browser starts automatically on first tool call using a persistent browser profile. Configure via CLI args in the MCP server configuration: `npx chrome-devtools-mcp@latest --help`.
+
+**Browser selection**: With no browser selection arguments, stable channel Chrome browser is the default. You can use `--browser=edge` to specify the Microsoft Edge browser. You can also use `--channel=stable|beta|dev|canary` to specify a channel. Alternatively, use `--executablePath` to specify the binary path of the browser you want to use.
 
 **Page selection**: Tools operate on the currently selected page. Use `list_pages` to see available pages, then `select_page` to switch context.
 

src/McpContext.ts

@@ -7,6 +7,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 
+import {isExtensionUrl} from './browser.js';
 import type {TargetUniverse} from './DevtoolsUtils.js';
 import {UniverseManager} from './DevtoolsUtils.js';
 import {McpPage} from './McpPage.js';
@@ -508,7 +509,7 @@ export class McpContext implements Context {
     const serviceWorkers = allTargets.filter(target => {
       return (
         target.type() === 'service_worker' &&
-        target.url().includes('chrome-extension://')
+        isExtensionUrl(target.url()
       );
     });
 
@@ -589,7 +590,7 @@ export class McpContext implements Context {
     const allTargets = this.browser.targets();
     const extensionTargets = allTargets.filter(target => {
       return (
-        target.url().startsWith('chrome-extension://') &&
+        isExtensionUrl(target.url()) && 
         target.type() === 'page'
       );
     });

src/McpResponse.ts

@@ -5,6 +5,7 @@
  */
 
 import type {ParsedArguments} from './bin/chrome-devtools-mcp-cli-options.js';
+import {isExtensionUrl} from './browser.js';
 import {ConsoleFormatter} from './formatters/ConsoleFormatter.js';
 import {IssueFormatter} from './formatters/IssueFormatter.js';
 import {NetworkFormatter} from './formatters/NetworkFormatter.js';
@@ -567,7 +568,7 @@ Call ${handleDialog.name} to handle it before continuing.`);
 
       const {regularPages, extensionPages} = allPages.reduce(
         (acc: {regularPages: Page[]; extensionPages: Page[]}, page: Page) => {
-          if (page.url().startsWith('chrome-extension://')) {
+          if (isExtensionUrl(page.url())) {
             acc.extensionPages.push(page);
           } else {
             acc.regularPages.push(page);

src/bin/chrome-devtools-mcp-cli-options.ts

@@ -4,6 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import os from 'node:os';
+
 import type {YargsOptions} from '../third_party/index.js';
 import {yargs, hideBin} from '../third_party/index.js';
 
@@ -116,6 +118,12 @@ export const cliOptions = {
     choices: ['stable', 'canary', 'beta', 'dev'] as const,
     conflicts: ['browserUrl', 'wsEndpoint', 'executablePath'],
   },
+  browser: {
+    type: 'string',
+    description: 'Specify which browser to use. Defaults to Chrome.',
+    choices: ['chrome', 'edge'] as const,
+    default: 'chrome',
+  },
   logFile: {
     type: 'string',
     describe:
@@ -272,6 +280,12 @@ export function parseArguments(version: string, argv = process.argv) {
       ) {
         args.channel = 'stable';
       }
+      // Edge Canary is not available on Linux.
+      if (args.browser === 'edge' && args.channel === 'canary' && os.platform() === 'linux') {
+        throw new Error(
+          `Edge Canary is not available on Linux. Use --executablePath to specify a custom Edge binary.`,
+        );
+      }
       return true;
     })
     .example([
@@ -291,6 +305,7 @@ export function parseArguments(version: string, argv = process.argv) {
       ['$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 --browser edge', 'Use Microsoft Edge instead of Chrome'],
       ['$0 --logFile /tmp/log.txt', 'Save logs to a file'],
       ['$0 --help', 'Print CLI options'],
       [
@@ -323,6 +338,10 @@ export function parseArguments(version: string, argv = process.argv) {
         '$0 --auto-connect --channel=canary',
         'Connect to a canary Chrome instance (Chrome 144+) running instead of launching a new instance',
       ],
+      [
+        '$0 --auto-connect --browser=edge',
+        'Connect to a stable Edge instance running instead of launching a new instance',
+      ],
       [
         '$0 --no-usage-statistics',
         'Do not send usage statistics https://github.com/ChromeDevTools/chrome-devtools-mcp#usage-statistics.',

src/browser.ts

@@ -9,6 +9,10 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 
+import {
+  resolveEdgeExecutablePath,
+  resolveEdgeUserDataDir,
+} from './edgePaths.js';
 import {logger} from './logger.js';
 import type {
   Browser,
@@ -21,17 +25,23 @@ import {puppeteer} from './third_party/index.js';
 let browser: Browser | undefined;
 
 function makeTargetFilter(enableExtensions = false) {
-  const ignoredPrefixes = new Set(['chrome://', 'chrome-untrusted://']);
+  const ignoredPrefixes = new Set([
+    'chrome://',
+    'chrome-untrusted://',
+    'edge://',
+    'edge-untrusted://',
+  ]);
   if (!enableExtensions) {
     ignoredPrefixes.add('chrome-extension://');
+    ignoredPrefixes.add('edge-extension://');
   }
 
   return function targetFilter(target: Target): boolean {
-    if (target.url() === 'chrome://newtab/') {
+    if (isBrowserNewTabUrl(target.url())) {
       return true;
     }
     // Could be the only page opened in the browser.
-    if (target.url().startsWith('chrome://inspect')) {
+    if (isBrowserInspectUrl(target.url())) {
       return true;
     }
     for (const prefix of ignoredPrefixes) {
@@ -49,10 +59,11 @@ export async function ensureBrowserConnected(options: {
   wsHeaders?: Record<string, string>;
   devtools: boolean;
   channel?: Channel;
+  browserKind?: BrowserKind;
   userDataDir?: string;
   enableExtensions?: boolean;
 }) {
-  const {channel, enableExtensions} = options;
+  const {channel, enableExtensions, browserKind = 'chrome'} = options;
   if (browser?.connected) {
     return browser;
   }
@@ -72,7 +83,12 @@ export async function ensureBrowserConnected(options: {
   } else if (options.browserURL) {
     connectOptions.browserURL = options.browserURL;
   } else if (channel || options.userDataDir) {
-    const userDataDir = options.userDataDir;
+    let userDataDir = options.userDataDir;
+    // Puppeteer's runtime does not resolve Edge channels, so we find
+    // Edge's default user data dir ourselves for auto-connect.
+    if (!userDataDir && browserKind === 'edge' && channel) {
+      userDataDir = resolveEdgeUserDataDir(channel);
+    }
     if (userDataDir) {
       autoConnect = true;
       // TODO: re-expose this logic via Puppeteer.
@@ -98,7 +114,7 @@ export async function ensureBrowserConnected(options: {
         connectOptions.browserWSEndpoint = browserWSEndpoint;
       } catch (error) {
         throw new Error(
-          `Could not connect to Chrome in ${userDataDir}. Check if Chrome is running and remote debugging is enabled by going to chrome://inspect/#remote-debugging.`,
+          `Could not connect to ${browserName(browserKind)} in ${userDataDir}. Check if ${browserName(browserKind)} is running and remote debugging is enabled by going to ${inspectUrl(browserKind)}.`,
           {
             cause: error,
           },
@@ -123,7 +139,7 @@ export async function ensureBrowserConnected(options: {
     browser = await puppeteer.connect(connectOptions);
   } catch (err) {
     throw new Error(
-      `Could not connect to Chrome. ${autoConnect ? `Check if Chrome is running and remote debugging is enabled by going to chrome://inspect/#remote-debugging.` : `Check if Chrome is running.`}`,
+      `Could not connect to ${browserName(browserKind)}. ${autoConnect ? `Check if ${browserName(browserKind)} is running and remote debugging is enabled by going to ${inspectUrl(browserKind)}.` : `Check if ${browserName(browserKind)} is running.`}`,
       {
         cause: err,
       },
@@ -137,6 +153,7 @@ interface McpLaunchOptions {
   acceptInsecureCerts?: boolean;
   executablePath?: string;
   channel?: Channel;
+  browserKind?: BrowserKind;
   userDataDir?: string;
   headless: boolean;
   isolated: boolean;
@@ -171,11 +188,18 @@ export function detectDisplay(): void {
 }
 
 export async function launch(options: McpLaunchOptions): Promise<Browser> {
-  const {channel, executablePath, headless, isolated} = options;
+  const {
+    channel,
+    executablePath,
+    headless,
+    isolated,
+    browserKind = 'chrome',
+  } = options;
+  const browserPrefix = browserKind === 'edge' ? 'edge' : 'chrome';
   const profileDirName =
     channel && channel !== 'stable'
-      ? `chrome-profile-${channel}`
-      : 'chrome-profile';
+      ? `${browserPrefix}-profile-${channel}`
+      : `${browserPrefix}-profile`;
 
   let userDataDir = options.userDataDir;
   if (!isolated && !userDataDir) {
@@ -204,11 +228,19 @@ export async function launch(options: McpLaunchOptions): Promise<Browser> {
   if (options.devtools) {
     args.push('--auto-open-devtools-for-tabs');
   }
-  if (!executablePath) {
-    puppeteerChannel =
-      channel && channel !== 'stable'
-        ? (`chrome-${channel}` as ChromeReleaseChannel)
-        : 'chrome';
+  let resolvedExecutablePath = executablePath;
+  if (!resolvedExecutablePath) {
+    if (browserKind === 'edge') {
+      // Puppeteer's runtime does not resolve Edge channels, so we find the
+      // Edge executable ourselves and pass it as executablePath.
+      const edgeChannel = channel ?? 'stable';
+      resolvedExecutablePath = resolveEdgeExecutablePath(edgeChannel);
+    } else {
+      puppeteerChannel =
+        channel && channel !== 'stable'
+          ? (`chrome-${channel}` as ChromeReleaseChannel)
+          : 'chrome';
+    }
   }
 
   if (!headless) {
@@ -219,7 +251,7 @@ export async function launch(options: McpLaunchOptions): Promise<Browser> {
     const browser = await puppeteer.launch({
       channel: puppeteerChannel,
       targetFilter: makeTargetFilter(options.enableExtensions),
-      executablePath,
+      executablePath: resolvedExecutablePath,
       defaultViewport: null,
       userDataDir,
       pipe: true,
@@ -271,3 +303,33 @@ export async function ensureBrowserLaunched(
 }
 
 export type Channel = 'stable' | 'canary' | 'beta' | 'dev';
+
+export type BrowserKind = 'chrome' | 'edge';
+
+export function browserName(browserKind: BrowserKind): string {
+  return browserKind === 'edge' ? 'Edge' : 'Chrome';
+}
+
+export function inspectUrl(browserKind: BrowserKind): string {
+  return browserKind === 'edge'
+    ? 'edge://inspect/#remote-debugging'
+    : 'chrome://inspect/#remote-debugging';
+}
+
+export function isExtensionUrl(url: string): boolean {
+  return url.startsWith('chrome-extension://') || 
+    url.startsWith('edge-extension://');
+}
+
+export function isBrowserNewTabUrl(url: string): boolean {
+  return url === 'chrome://newtab/' || url === 'edge://newtab/';
+}
+
+export function isBrowserInspectUrl(url: string): boolean {
+  return url.startsWith('chrome://inspect') || url.startsWith('edge://inspect');
+}
+
+export {
+  resolveEdgeExecutablePath,
+  resolveEdgeUserDataDir,
+} from './edgePaths.js';