Chrome Debug MCP Playwright

Features

Core Browser Features

• Browser launch and management

• Multi-tab support with create/switch/close capabilities

• Page navigation and interaction

• Screenshot capture

Greasemonkey API Support

• GM_addStyle for CSS injection

• GM_getValue/GM_setValue for data storage

• GM_deleteValue for storage cleanup

• GM_notification for desktop notifications

• GM_setClipboard for clipboard operations

• GM_xmlhttpRequest for cross-origin requests

Resource Management

• Network request interception

• Request blocking, modification, and logging

• Resource type filtering

Debug Features

• Detailed logging system

• Log file organization

• Clean interface output

Installation

Quick Start

Documentation

• Commands - Detailed command documentation with examples

• Full command list with usage examples available in COMMANDS.md

Core Features

Browser Management

Greasemonkey API

Resource Interception

Implementation Details

Logging System

• All debug output redirected to log files

• Timestamped entries

• Organized in logs directory

• Clean interface output

Error Handling

• Detailed error logging

• Proper cleanup on errors

• Resource management

Dependencies

• Playwright: Browser automation

• @modelcontextprotocol/sdk: MCP implementation

Development

Prerequisites

• Node.js 16 or higher

• npm 7 or higher

Setup

License

Contributing

Acknowledgments

Based on the original [chrome-debug-mcp](https://github.com/robertheadley/chrome-debug-mcp) by Robert Headley.

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload)

Chrome Debug MCP Server

<<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) <a href="https://glama.ai/mcp/servers/nguhnsghor"> <img width="380" height="200" src="https://glama.ai/mcp/servers/nguhnsghor/badge" alt="Chrome Debug Server MCP server" /> </a>

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload)

Features

Chrome Control

• Launch Chrome with custom configurations

• Support for custom Chrome executable paths

• User profile management (default or custom user data directory)

• Extension support and management

• Disable Chrome's "Automation Controlled" banner

<<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload)

Page Automation

• Click, type, and interact with page elements

• Handle dropdowns and form inputs

• Hover and wait for elements

• Take screenshots of full page or elements

• Navigate between pages

• Set viewport size and device emulation

• Extract text and attributes from elements

Tab Management

• List all open tabs with their IDs and URLs

• Open new tabs with specified URLs

• Close tabs by ID

• Switch between tabs

• Track and manage multiple tab states

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload)

Debugging Capabilities

• Remote debugging via Chrome DevTools Protocol (CDP)

• Console log capture and monitoring

• JavaScript evaluation in page context

• Real-time console output streaming

Userscript Support

• Inject userscripts into web pages

• Greasemonkey-style API support:

Extension Integration

• Load unpacked extensions

• Maintain extension states and configurations

• Support for default Chrome profile extensions

• Selective extension enabling/disabling

Installation

Prerequisites

• Node.js (v14 or higher)

• Chrome browser installed

• Visual Studio Code

• Roo Code Extension

Installing Roo Code Extension

1. Open Visual Studio Code

2. Go to Extensions (Ctrl+Shift+X)

3. Search for "Roo Code"

4. Click Install

Setting up Chrome Debug MCP Server

1. Clone this repository:

2. Install dependencies:

3. Build the project:

4. Configure in Roo Code: Add to cline_mcp_settings.json:

Usage

<<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD

>>>>>> parent of 64acbb3 (Add files via upload) ======= For a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).

>>>>>> parent of 64acbb3 (Add files via upload) ======= For a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).

>>>>>> parent of 64acbb3 (Add files via upload) ======= For a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).

>>>>>> parent of 64acbb3 (Add files via upload) ======= For a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).

>>>>>> parent of 64acbb3 (Add files via upload) ======= For a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).

>>>>>> parent of 64acbb3 (Add files via upload) ======= For a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).

>>>>>> parent of 64acbb3 (Add files via upload)

Basic Chrome Launch

Launch with Custom Profile

Inject Userscript

Evaluate JavaScript

Get Console Logs

<<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload)

Page Interaction Examples

Click an Element

Type into Input

Select from Dropdown

Wait for Element

Take Screenshot

Set Viewport Size

Tab Management Examples

List All Tabs

Open New Tab

Switch to Tab

Close Tab

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload)

Dependencies

• Puppeteer - Chrome automation library

• chrome-remote-interface - Chrome DevTools Protocol client

• @modelcontextprotocol/sdk - MCP SDK for server implementation

License

Contributing

Acknowledgments

• Chrome DevTools Protocol

• Greasemonkey API <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD

• Model Context Protocol

• Model Context Protocol

• Model Context Protocol

• Model Context Protocol

• Model Context Protocol

• Model Context Protocol

• Model Context Protocol

• Model Context Protocol

Chrome Debug MCP Playwright

Features

Core Browser Features

• Browser launch and management

• Multi-tab support with create/switch/close capabilities

• Page navigation and interaction

• Screenshot capture

Greasemonkey API Support

• GM_addStyle for CSS injection

• GM_getValue/GM_setValue for data storage

• GM_deleteValue for storage cleanup

• GM_notification for desktop notifications

• GM_setClipboard for clipboard operations

• GM_xmlhttpRequest for cross-origin requests

Resource Management

• Network request interception

• Request blocking, modification, and logging

• Resource type filtering

Debug Features

• Detailed logging system

• Log file organization

• Clean interface output

Installation

Quick Start

Documentation

• Commands - Detailed command documentation with examples

• Full command list with usage examples available in COMMANDS.md

Core Features

Browser Management

Greasemonkey API

Resource Interception

Implementation Details

Logging System

• All debug output redirected to log files

• Timestamped entries

• Organized in logs directory

• Clean interface output

Error Handling

• Detailed error logging

• Proper cleanup on errors

• Resource management

Dependencies

• Playwright: Browser automation

• @modelcontextprotocol/sdk: MCP implementation

Development

Prerequisites

• Node.js 16 or higher

• npm 7 or higher

Setup

License

Contributing

Acknowledgments

Based on the original [chrome-debug-mcp](https://github.com/robertheadley/chrome-debug-mcp) by Robert Headley.

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload)

Chrome Debug MCP Server

<<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) <a href="https://glama.ai/mcp/servers/nguhnsghor"> <img width="380" height="200" src="https://glama.ai/mcp/servers/nguhnsghor/badge" alt="Chrome Debug Server MCP server" /> </a>

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload)

Features

Chrome Control

• Launch Chrome with custom configurations

• Support for custom Chrome executable paths

• User profile management (default or custom user data directory)

• Extension support and management

• Disable Chrome's "Automation Controlled" banner

<<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload)

Page Automation

• Click, type, and interact with page elements

• Handle dropdowns and form inputs

• Hover and wait for elements

• Take screenshots of full page or elements

• Navigate between pages

• Set viewport size and device emulation

• Extract text and attributes from elements

Tab Management

• List all open tabs with their IDs and URLs

• Open new tabs with specified URLs

• Close tabs by ID

• Switch between tabs

• Track and manage multiple tab states

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload)

Debugging Capabilities

• Remote debugging via Chrome DevTools Protocol (CDP)

• Console log capture and monitoring

• JavaScript evaluation in page context

• Real-time console output streaming

Userscript Support

• Inject userscripts into web pages

• Greasemonkey-style API support:

Extension Integration

• Load unpacked extensions

• Maintain extension states and configurations

• Support for default Chrome profile extensions

• Selective extension enabling/disabling

Installation

Prerequisites

• Node.js (v14 or higher)

• Chrome browser installed

• Visual Studio Code

• Roo Code Extension

Installing Roo Code Extension

1. Open Visual Studio Code

2. Go to Extensions (Ctrl+Shift+X)

3. Search for "Roo Code"

4. Click Install

Setting up Chrome Debug MCP Server

1. Clone this repository:

2. Install dependencies:

3. Build the project:

4. Configure in Roo Code: Add to cline_mcp_settings.json:

Usage

<<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD

>>>>>> parent of 64acbb3 (Add files via upload) ======= For a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).

>>>>>> parent of 64acbb3 (Add files via upload) ======= For a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).

>>>>>> parent of 64acbb3 (Add files via upload) ======= For a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).

>>>>>> parent of 64acbb3 (Add files via upload) ======= For a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).

>>>>>> parent of 64acbb3 (Add files via upload) ======= For a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).

>>>>>> parent of 64acbb3 (Add files via upload) ======= For a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).

>>>>>> parent of 64acbb3 (Add files via upload)

Basic Chrome Launch

Launch with Custom Profile

Inject Userscript

Evaluate JavaScript

Get Console Logs

<<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload)

Page Interaction Examples

Click an Element

Type into Input

Select from Dropdown

Wait for Element

Take Screenshot

Set Viewport Size

Tab Management Examples

List All Tabs

Open New Tab

Switch to Tab

Close Tab

>>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload) ======= >>>>>> parent of 64acbb3 (Add files via upload)

Dependencies

• Puppeteer - Chrome automation library

• chrome-remote-interface - Chrome DevTools Protocol client

• @modelcontextprotocol/sdk - MCP SDK for server implementation

License

Contributing

Acknowledgments

• Chrome DevTools Protocol

• Greasemonkey API <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD <<<<<<< HEAD

• Model Context Protocol

• Model Context Protocol

• Model Context Protocol

• Model Context Protocol

• Model Context Protocol

• Model Context Protocol

• Model Context Protocol

• Model Context Protocol