@dubaigit/bdg-mcp

MCP (Model Context Protocol) server for browser debugging via Chrome DevTools Protocol (CDP).

Key feature: Connect to remote Chrome browsers with API key authentication - works with Fly.io, AWS, or any cloud-hosted Chrome instance.

Installation

npm install -g @dubaigit/bdg-mcp

Add to Claude Code

claude mcp add bdg-mcp -- npx -y @dubaigit/bdg-mcp

Or manually add to ~/.claude.json:

{
  "mcpServers": {
    "bdg-mcp": {
      "command": "npx",
      "args": ["-y", "@dubaigit/bdg-mcp"]
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | connect_browser | Connect to remote Chrome via WebSocket URL with API key auth | | disconnect_browser | Disconnect from current session | | browser_status | Check connection status | | navigate | Navigate to a URL | | screenshot | Capture page screenshot (png/jpeg/webp, full page support) | | evaluate | Execute JavaScript in page context | | get_page_content | Get full HTML of current page | | get_page_info | Get URL and title | | query_selector | Find elements by CSS selector | | click | Click on element | | type_text | Type text into input fields | | cdp | Execute raw CDP commands | | reload | Reload page | | go_back / go_forward | Browser history navigation |

Usage Example

1. Connect to a remote Chrome browser:

connect_browser with wsUrl: "wss://your-chrome.fly.dev:9226/devtools/page/PAGE_ID?apiKey=YOUR_API_KEY"

2. Navigate and interact:

navigate to "https://example.com"
screenshot
get_page_info

3. Execute JavaScript:

evaluate expression: "document.title"

4. Raw CDP commands:

cdp method: "Page.printToPDF" params: { printBackground: true }

Remote Chrome Setup

This MCP server is designed to work with remote Chrome browsers. You can set up a remote Chrome with CDP proxy using:

• Fly.io: Deploy Chrome in a Docker container with a CDP proxy that handles API key authentication
• Your own infrastructure: Any Chrome instance with --remote-debugging-port exposed

Example WebSocket URL format:

wss://hostname:port/devtools/page/PAGE_ID?apiKey=YOUR_API_KEY

License

MIT