About

Chromium MCP is a fork of Browser MCP that adds support for automatically launching Chrome/Chromium with the Browser MCP extension loaded.

This MCP server + Chrome extension allows you to automate your browser using AI applications like VS Code, Claude, Cursor, and Windsurf.

What's New in This Fork

🚀 Chrome Launcher Tool

This fork adds a new launch_browser tool that automatically:

• Launches Chrome with your specified profile
• Loads the Browser MCP extension
• Waits for the extension to connect
• Returns when ready to receive commands

No more manual setup! Just call the tool and start automating.

Features

• ⚡ Fast: Automation happens locally on your machine, resulting in better performance without network latency.
• 🔒 Private: Since automation happens locally, your browser activity stays on your device and isn't sent to remote servers.
• 👤 Logged In: Uses your existing browser profile, keeping you logged into all your services.
• 🥷🏼 Stealth: Avoids basic bot detection and CAPTCHAs by using your real browser fingerprint.
• 🚀 Auto-Launch: NEW! Automatically launch Chrome with the extension loaded.

Installation

NPM Package (Recommended)

npm install -g @remenby/chromium-mcp

Or use with npx:

{
  "mcpServers": {
    "chromium-mcp": {
      "command": "npx",
      "args": ["@remenby/chromium-mcp@latest"]
    }
  }
}

From Source

git clone https://github.com/Remenby31/chromium-mcp.git
cd chromium-mcp
npm install
npm run build

Usage

With Claude Desktop / MCP-compatible clients

Add to your MCP configuration file:

For Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "chromium-mcp": {
      "command": "npx",
      "args": ["@remenby/chromium-mcp@latest"]
    }
  }
}

Using the Chrome Launcher

Once connected to the MCP server, you can use the new launch_browser tool:

launch_browser with:
- extensionPath: "/path/to/browser-mcp-extension"
- url: "https://example.com" (optional)
- profilePath: "/path/to/chrome/profile" (optional)

The tool will:

1. Launch Chrome with the extension loaded
2. Wait for the extension to connect (default: 30 seconds timeout)
3. Return success when ready

Requirements:

• The Browser MCP extension must be unpacked (not a .crx file)
• The extension should be configured to auto-connect, or you must click "Connect" within the timeout period

Available Tools

Navigation

• browser_navigate - Navigate to a URL
• browser_go_back - Go back in browser history
• browser_go_forward - Go forward in browser history

Interaction

• browser_snapshot - Capture an accessibility tree snapshot of the page
• browser_click - Click on an element
• browser_hover - Hover over an element
• browser_type - Type text into an element
• browser_select_option - Select an option in a dropdown
• browser_press_key - Press a keyboard key

Utility

• browser_wait - Wait for a specified time
• browser_get_console_logs - Get console logs from the browser
• browser_screenshot - Take a screenshot of the current page
• launch_browser - NEW! Launch Chrome with the Browser MCP extension

Configuration

The default WebSocket port is 9333. You can change this in src/config/mcp.config.ts.

Differences from Original

This fork is fully standalone and doesn't depend on the monorepo packages. All necessary code has been extracted and included locally:

• Configuration (@repo/config → src/config)
• Types (@repo/types → src/types)
• Messaging (@r2r/messaging → src/messaging)
• Utils (@repo/utils → src/utils)

Development

# Install dependencies
npm install

# Build the project
npm run build

# Type check
npm run typecheck

# Watch mode
npm run watch

Publishing to NPM

1. Login to npm:

npm login

2. Update version in package.json

3. Build and publish:

npm run build
npm publish --access public

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

This is a fork of Browser MCP. For the original project, see BrowserMCP/mcp.

Credits

• Chromium MCP (this fork) by Remenby31
• Original Browser MCP by Browser MCP
• Adapted from Playwright MCP server

License

Apache 2.0 - See LICENSE file for details