npm package: @remenby/chromium-mcp
Description: MCP server for Chromium/Chrome browser automation - Fork of Browser MCP with Chrome launcher
Author: remenby
Latest version: 0.2.0

<a href="https://browsermcp.io">
  <img src="./images/banner.png" alt="Browser MCP banner">
</a>

<h3 align="center">Chromium MCP</h3>

<p align="center">
  Automate Chromium/Chrome with AI - Fork of Browser MCP with automatic Chrome launching!
  <br />
  <a href="https://browsermcp.io"><strong>Browser MCP (Original)</strong></a>
  •
  <a href="https://docs.browsermcp.io"><strong>Docs</strong></a>
</p>

## About

**Chromium MCP** is a fork of [Browser MCP](https://github.com/BrowserMCP/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)

```bash
npm install -g @remenby/chromium-mcp
```

Or use with `npx`:

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

### From Source

```bash
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):

```json
{
  "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

```bash
# 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:
```bash
npm login
```

2. Update version in `package.json`

3. Build and publish:
```bash
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](https://github.com/BrowserMCP/mcp).

## Credits

- **Chromium MCP** (this fork) by [Remenby31](https://github.com/Remenby31)
- Original **Browser MCP** by [Browser MCP](https://browsermcp.io)
- Adapted from [Playwright MCP server](https://github.com/microsoft/playwright-mcp)

## License

Apache 2.0 - See [LICENSE](LICENSE) file for details