Chrome MCP Server

A Model Context Protocol (MCP) server that provides fine-grained control over a Chrome browser instance through the Chrome DevTools Protocol (CDP).

Prerequisites

Bun (recommended) or Node.js (v14 or higher)
Chrome browser with remote debugging enabled

Setup

Installing Bun

Install Bun (if not already installed):

# macOS, Linux, or WSL
curl -fsSL https://bun.sh/install | bash

# Windows (using PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"

# Alternatively, using npm
npm install -g bun

Start Chrome with remote debugging enabled:You can use the included script which automatically detects your OS and starts Chrome with the correct command:
# Make the script executable chmod +x start-chrome.sh # Run the script ./start-chrome.sh
Or manually start Chrome with remote debugging:
# macOS /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 # Windows start chrome --remote-debugging-port=9222 # Linux google-chrome --remote-debugging-port=9222
Install dependencies:

bun install

Start the server:

bun start

For development with hot reloading:

bun dev

The server will start on port 3000 by default. You can change this by setting the PORT environment variable.

Configuring Roo Code to use this MCP server

To use this Chrome MCP server with Roo Code:

Open Roo Code settings
Navigate to the MCP settings configuration file at:
- macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
- Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
- Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
Add the following configuration to the mcpServers object:

{
  "mcpServers": {
    "chrome-control": {
      "url": "http://localhost:3000/sse-cursor",
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Save the file and restart Roo Code to apply the changes.
You can now use the Chrome MCP tools in Roo Code to control the browser.

Available Tools

The server provides the following tools for browser control:

navigate

Navigate to a specific URL.

Parameters:

url (string): The URL to navigate to

click

Click at specific coordinates.

Parameters:

x (number): X coordinate
y (number): Y coordinate

type

Type text at the current focus.

Parameters:

text (string): Text to type

clickElement

Click on an element by its index in the page info.

Parameters:

selector (string): Element index (e.g., "0" for the first element)

getText

Get text content of an element using a CSS selector.

Parameters:

selector (string): CSS selector to find the element

getPageInfo

Get semantic information about the page including interactive elements and text nodes.

getPageState

Get current page state including URL, title, scroll position, and viewport size.

Usage

The server implements the Model Context Protocol with SSE transport. Connect to the server at:

SSE endpoint: http://localhost:3000/sse-cursor
Messages endpoint: http://localhost:3000/message?sessionId=...

When using with Roo Code, the configuration in the MCP settings file will handle the connection automatically.

Development

To run the server in development mode with hot reloading:

bun dev

This uses Bun's built-in watch mode to automatically restart the server when files change.

License

MIT