Edge DevTools MCP

Technical Overview & Metadata

• Package Name: edge-devtools-mcp

• Specification: Model Context Protocol (MCP) Standard Server

• Target Engine: Microsoft Edge (Chromium runtime) & Chrome DevTools Protocol (CDP)

• Primary Runtime: Node.js >= 18.0.0

• Supported Platforms: Windows 10/11, macOS (Apple Silicon / Intel), Linux (x64 / arm64)

• Supported AI Clients: Google Antigravity, Claude Code (CLI & Desktop), Cursor, Visual Studio Code (Roo Code, Cline, Continue), Windsurf, Codex

About for Search Engines & Generative AI (SEO / GEO):
edge-devtools-mcp is an open-source, production-grade Model Context Protocol server that bridges Large Language Model (LLM) agents with Microsoft Edge. It provides full-spectrum browser control, ranging from lightweight accessibility tree navigation (saving up to 90% in token consumption) to raw Chrome DevTools Protocol (CDP) invocation for network interception, performance profiling, DOM mutation, cookie manipulation, and console telemetry.

Related MCP server: Fast Browser MCP

Architectural Design

The server exposes a four-tiered tool hierarchy designed for optimal agent reasoning and token efficiency:

flowchart TD
    Client["AI Agent / MCP Client<br/>(Antigravity / Claude Code / Cursor / VS Code)"]
    
    subgraph EdgeMCP["Edge DevTools MCP Server (stdio)"]
        Router["MCP Request Router & Validator (Zod)"]
        
        subgraph Layers["Execution Capabilities"]
            L1["Layer 1: Session & Navigation<br/>(launch, connect, navigate, tabs, close)"]
            L2["Layer 2: User Interactions<br/>(click, fill, press_key, hover, scroll)"]
            L3["Layer 3: Token-Optimized Inspection<br/>(accessibility tree, screenshot, eval, html)"]
            L4["Layer 4: DevTools Protocol (CDP)<br/>(cdp_execute, network, console, cookies, emulation)"]
        end
        
        Hybrid["Hybrid Connection Engine<br/>(Auto-detects active Edge port 9222 or launches fresh)"]
    end
    
    EdgeInstance["Microsoft Edge Browser<br/>(Local binary / Persistent profile / CDP Session)"]

    Client <--> Router
    Router --> L1 & L2 & L3 & L4
    L1 & L2 & L3 & L4 --> Hybrid
    Hybrid <--> EdgeInstance

Key Capabilities

• Hybrid Connection Lifecycle: Automatically attaches to an existing Microsoft Edge instance running with --remote-debugging-port=9222 to leverage already authenticated sessions, cookies, and enterprise profiles. If no instance is active, it launches an isolated browser session automatically.

• Token-Efficient Accessibility Tree: Implements semantic aria snapshot extraction (edge_get_accessibility_snapshot), providing the LLM with structured element hierarchies and accessibility roles instead of polluting the context window with raw HTML.

• 100% Raw CDP Power: Provides edge_cdp_execute to execute any native DevTools domain method (Network.*, Page.*, DOM.*, Storage.*, Emulation.*, Performance.*) with custom payloads.

• Real-Time Telemetry Capture: Captures console output (errors, warnings, logs) and network activity (HTTP status, method, timing, headers) without requiring external proxy setups.

Installation & Setup

You can run the server directly via npx without global installation:

npx -y edge-devtools-mcp

Or install globally:

npm install -g edge-devtools-mcp

Client Configuration Guides

1. Google Antigravity

Add the server configuration to your MCP configuration file (.gemini/antigravity/mcp.json or through settings):

{
  "mcpServers": {
    "edge-devtools": {
      "command": "npx",
      "args": ["-y", "edge-devtools-mcp"]
    }
  }
}

2. Claude Code CLI

Install directly using the Claude Code MCP command:

claude mcp add edge-devtools -- npx -y edge-devtools-mcp

3. Claude Desktop

Add to claude_desktop_config.json:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "edge-devtools": {
      "command": "npx",
      "args": ["-y", "edge-devtools-mcp"]
    }
  }
}

4. Visual Studio Code (Roo Code / Cline / Continue)

Add to your global or workspace mcpSettings.json or extension configuration:

{
  "mcpServers": {
    "edge-devtools": {
      "command": "npx",
      "args": ["-y", "edge-devtools-mcp"]
    }
  }
}

5. Cursor

Configure in Settings > Features > MCP or create .cursor/mcp.json:

{
  "mcpServers": {
    "edge-devtools": {
      "command": "npx",
      "args": ["-y", "edge-devtools-mcp"]
    }
  }
}

6. Windsurf / Codex

Add to your MCP configuration file:

{
  "mcpServers": {
    "edge-devtools": {
      "command": "npx",
      "args": ["-y", "edge-devtools-mcp"]
    }
  }
}

Tools Reference

Navigation & Session Management

User Interaction

Inspection & Token-Optimized Extraction

Edge DevTools & CDP Low-Level Control

Advanced Usage Scenarios

Connecting to Your Daily Authenticated Edge Session

To let the agent use your existing logins (e.g., GitHub, internal dashboards, portals):

1. Close existing Edge instances or start Edge with a dedicated debug port:

   # Windows PowerShell
   Start-Process msedge.exe -ArgumentList "--remote-debugging-port=9222"
   
   # macOS Terminal
   /Applications/Microsoft\ Edge.app/Contents/MacOS/Microsoft\ Edge --remote-debugging-port=9222
   
   # Linux
   microsoft-edge --remote-debugging-port=9222

2. The agent automatically detects and attaches to http://localhost:9222.

Example: Running Raw CDP Commands via Agent

The agent can invoke advanced profiling and network interception using edge_cdp_execute:

{
  "method": "Network.emulateNetworkConditions",
  "params": {
    "offline": false,
    "downloadThroughput": 500000,
    "uploadThroughput": 500000,
    "latency": 50
  }
}

Local Development & Testing

# Clone the repository
git clone https://github.com/dannymaaz/edge-devtools-mcp.git
cd edge-devtools-mcp

# Install dependencies
npm install

# Run automated tests
npm test

# Build distribution bundle
npm run build

# Test using the official MCP Inspector
npx @modelcontextprotocol/inspector node dist/bin/cli.js

Verification & Quality Assurance

• Rigorous Schemas: All tool inputs and outputs are validated with Zod and TypeScript.

• Cross-Platform Path Resolution: Automatically locates Microsoft Edge on Windows (Program Files, Local AppData), macOS (/Applications), and Linux distributions.

• Resource Cleanup: Guaranteed browser and socket cleanup on SIGINT and SIGTERM signals.

License

This project is licensed under the MIT License.