chrome-mcp

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

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

1. 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

2. Start Chrome with remote debugging enabled:

   # 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

3. Install dependencies:

bun install

4. 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.

To use this Chrome MCP server with Roo Code:

1. Open Roo Code settings

2. 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

3. Add the following configuration to the mcpServers object:

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

4. Save the file and restart Roo Code to apply the changes.

5. You can now use the Chrome MCP tools in Roo Code to control the browser.

The server provides the following tools for browser control:

Navigate to a specific URL.

Parameters:

• url (string): The URL to navigate to

Click at specific coordinates.

Parameters:

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

Type text at the current focus.

Parameters:

• text (string): Text to type

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

Parameters:

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

Get text content of an element using a CSS selector.

Parameters:

• selector (string): CSS selector to find the element

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

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

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

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

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

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.

MIT