Browser CDP MCP Server

A minimal MCP (Model Context Protocol) server that provides direct access to the Chrome DevTools Protocol (CDP) for maximum flexibility browser control.

Features

  • Raw CDP Access: Call any Chrome DevTools Protocol method directly via cdp_send
  • Screenshot Capture: Take screenshots in PNG or JPEG format
  • URL Retrieval: Get the current page URL
  • Browser Management: Launch and close browser instances

Installation

npm install

Usage

npm start

The server communicates over stdio using the MCP protocol.

Tools

cdp_send

Execute any CDP method. Reference: https://chromedevtools.github.io/devtools-protocol/

Parameters:

  • method (string): CDP method name (e.g., Page.navigate, DOM.getDocument, Runtime.evaluate)
  • params (object, optional): Parameters for the CDP method

Example:

{
  "method": "Page.navigate",
  "params": { "url": "https://example.com" }
}

screenshot

Capture a screenshot of the current page.

Parameters:

  • format (string, optional): "png" or "jpeg" (default: "png")
  • fullPage (boolean, optional): Capture full scrollable page (default: false)

get_url

Returns the current page URL.

close_browser

Closes the browser instance and cleans up resources.

MCP Configuration

Add to your MCP client configuration:

claude mcp add-json browser '{
  "type": "stdio",
  "command": "node",
  "args": ["path/to/browser-tool/server.js"]
}' --scope user

Skill Integration

Add the browser skill to claude:

cp .path/to/browser-tool/.claude/skills/browser.md ~/.claude/skills/browser.md

Dependencies

  • @modelcontextprotocol/sdk - MCP SDK for server implementation
  • playwright - Browser automation
  • zod - Schema validation

License

MIT

S
Description
Hanzo Bot skill: verify-on-browser (by myestery)
Readme
40 KiB
Languages
JavaScript 100%