Chrome DevTools Debug MCP Server

An MCP server for Chrome DevTools Protocol debugging capabilities. Provides full access to browser debugging features including breakpoints, network interception, DOM inspection, and more.

Installation

Add to your MCP client configuration:

{
  "mcpServers": {
    "chrome-devtools-debug": {
      "command": "npx",
      "args": ["chrome-devtools-debug-mcp@latest"]
    }
  }
}

Tools Reference

Browser / Connection

Tool	Description
start_chrome	Launch Chrome with debugging enabled
stop_chrome	Stop the Chrome process started with start_chrome
connect	Connect to an existing Chrome instance
disconnect	Disconnect from Chrome without stopping the browser
get_version	Get Chrome version and protocol version

Target Domain

Manage browser targets (pages/tabs).

Tool	Description
list_targets	List all targets (pages, workers, etc.)
create_target	Create a new target (page/tab)
switch_target	Switch to a different target (page/tab)
close_target	Close a target (page/tab)

Page Domain

Tool	Description
navigate	Navigate the current page to a URL
reload	Reload the current page
capture_screenshot	Capture a screenshot (png/jpeg/webp), optionally clipped to a region
capture_snapshot	Capture full page as MHTML (includes HTML, CSS, images)
get_frame_tree	Get the frame hierarchy including all iframes
create_isolated_world	Create an isolated JS execution context in a frame
add_script_on_new_document	Add a script to run on every new document
remove_script_on_new_document	Remove a script added with add_script_on_new_document
handle_dialog	Handle JavaScript dialogs (alert, confirm, prompt)
delete_cookie	Delete a browser cookie by name

Debugger Domain

Control JavaScript debugging with breakpoints and stepping.

Tool	Description
debugger_enable	Enable the debugger (required before setting breakpoints)
debugger_disable	Disable the debugger and remove all breakpoints
set_breakpoint	Set a breakpoint by URL pattern and line number
set_breakpoint_by_id	Set a breakpoint at a specific location in a loaded script
remove_breakpoint	Remove a breakpoint by its ID
list_breakpoints	List all active breakpoints
pause	Pause JavaScript execution
resume	Resume JavaScript execution
step_over	Step to the next line, stepping over function calls
step_into	Step into a function call
step_out	Step out of the current function
get_call_frames	Get the current call stack when paused
get_scope_variables	Get variables in a scope of a call frame
evaluate_on_frame	Evaluate an expression in the context of a call frame
set_pause_on_exceptions	Configure when to pause on exceptions (none/uncaught/all)
set_async_stack_depth	Set maximum depth of async call stacks
list_scripts	List all parsed scripts
get_script_source	Get the source code of a script
get_pause_state	Get current pause state of the debugger

Runtime Domain

Evaluate JavaScript and inspect objects.

Tool	Description
evaluate	Evaluate JavaScript expression in the page context
get_properties	Get properties of an object by its objectId
release_object	Release an object reference to free memory
get_console_messages	Get collected console messages (console.log, console.error, etc.)
get_exceptions	Get collected runtime exceptions
clear_console	Clear collected console messages and exceptions

Network Domain

Monitor network requests and responses.

Tool	Description
network_enable	Enable network request collection
network_disable	Disable network request collection
list_requests	List collected network requests
get_request_details	Get detailed information about a network request
get_response_body	Get the response body of a completed request
clear_requests	Clear collected network requests
get_network_summary	Get summary of collected network requests

Fetch Domain

Intercept and modify network requests.

Tool	Description
fetch_enable	Enable request interception
fetch_disable	Disable request interception
add_intercept_rule	Add a rule for handling intercepted requests
remove_intercept_rule	Remove an intercept rule
list_intercept_rules	List all intercept rules
list_paused_requests	List requests paused waiting for a decision
continue_request	Continue a paused request, optionally modifying it
fulfill_request	Respond to a paused request with a mock response
fulfill_request_with_file	Respond to a paused request with file contents
fail_request	Fail a paused request with an error

DOM Domain

Inspect and query the DOM tree.

Tool	Description
dom_enable	Enable DOM domain for DOM tree access
dom_disable	Disable DOM domain
get_document	Get the root DOM node
query_selector	Find an element by CSS selector
query_selector_all	Find all elements matching a CSS selector
get_outer_html	Get the outer HTML of an element
get_attributes	Get attributes of an element
get_box_model	Get the box model (dimensions and position) of an element
resolve_node	Get a JavaScript object reference for a DOM node

DOMDebugger Domain

Set breakpoints on DOM mutations and events.

Tool	Description
set_dom_breakpoint	Set a breakpoint on DOM mutations (subtree/attribute/removal)
remove_dom_breakpoint	Remove a DOM breakpoint
set_event_breakpoint	Break when a specific event is fired (click, submit, etc.)
remove_event_breakpoint	Remove an event breakpoint
set_xhr_breakpoint	Break when an XHR/fetch request matches a URL pattern
remove_xhr_breakpoint	Remove an XHR breakpoint
get_event_listeners	Get all event listeners attached to an element

Input Domain

Simulate user input (mouse, keyboard).

Tool	Description
click	Click at coordinates
click_element	Click on an element by node ID (clicks at center)
type_text	Type text into the focused element
press_key	Press a key or key combination
scroll	Scroll the page or an element
move_mouse	Move the mouse to a position

Log Domain

Collect browser-level logs.

Tool	Description
log_enable	Enable browser log collection
log_disable	Disable browser log collection
get_log_entries	Get collected browser log entries
clear_log	Clear collected log entries

ServiceWorker Domain

Manage service workers.

Tool	Description
service_worker_enable	Enable ServiceWorker domain to track service workers
service_worker_disable	Disable ServiceWorker tracking
list_service_workers	List all registered service workers
start_worker	Start a service worker
stop_worker	Stop a running service worker
update_registration	Force update a service worker registration
skip_waiting	Skip waiting state for a service worker

License

MIT