# Bruster

> Bruster is an open-source MCP server for browser automation. Rust browser automation over native webviews, for agents (MCP) and scripts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, Windows, CLI, self-hosted
- **Website:** https://aliilyas.github.io/bruster/
- **Repository:** https://github.com/aliilyas/bruster
- **MCP Registry name:** io.github.aliilyas/bruster
- **Categories:** browser automation
- **Listing updated:** 2026-11-14

## About

Instead of bundling a full browser engine, Bruster drives the webview your OS already has: WKWebView on macOS, WebKitGTK on Linux and WebView2 on Windows. The project says that means no Node.js, and publishes a benchmark of a 154.8 ms median launch to first loaded page, 221.7 MiB idle memory and 428.4 MB of installed files on Linux, with comparisons to Playwright and Puppeteer.

Agents read compact DOM snapshots, act using element references such as `e3`, and receive screenshots as images. The same browser is reachable through a JSON-lines protocol on stdin and stdout, so a Python script using only `subprocess` can drive it. Persistent profiles keep cookies and storage, `--visible` shows the window, and a small `.bru` test DSL with retrying assertions and failure screenshots ships in source builds.

Install by script, release archive or the Docker image, which includes WebKitGTK and a virtual display for amd64 and arm64. Linux needs WebKitGTK 4.1, and without a desktop Xvfb. The project is MIT licensed.

## Features

- **Native webview engine:** Uses WKWebView, WebKitGTK or WebView2 instead of a bundled browser.
- **Snapshot and ref actions:** Inspect the DOM text, then click or fill by element reference.
- **JSON-lines API:** Drive it from any language that can start a process.
- **Persistent profiles:** Keep cookies and storage across sessions.
- **Built-in test runner:** Write .bru tests with retrying assertions.
- **Docker image:** Ships WebKitGTK and Xvfb for headless runs.

## Good for

- Let an agent fill a form and screenshot the result
- Run smoke tests against a local dev server
- Extract rendered text from a page in a script
- Automate browsing without installing Node.js

## Install

### Claude Code (Terminal)

```sh
claude mcp add bruster -- npx -y https://github.com/aliilyas/bruster/releases/download/v0.3.2/bruster-0.3.2.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bruster": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/aliilyas/bruster/releases/download/v0.3.2/bruster-0.3.2.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bruster": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/aliilyas/bruster/releases/download/v0.3.2/bruster-0.3.2.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bruster": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/aliilyas/bruster/releases/download/v0.3.2/bruster-0.3.2.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bruster": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/aliilyas/bruster/releases/download/v0.3.2/bruster-0.3.2.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bruster": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/aliilyas/bruster/releases/download/v0.3.2/bruster-0.3.2.mcpb"
      ]
    }
  }
}
```

## FAQ

### Does it need Node.js?

No, the site says no Node.js is required.

### Which platforms work?

macOS, Linux and Windows.

### How do I start the MCP server?

Run `bruster --mcp --quiet` from your client, or `docker run --rm -i ilyastmn/bruster:latest`.

### What licence is it?

MIT.

### Is Bruster free?

Yes. Bruster is open source, so you can use and self-host it for free.

### How do I add Bruster to Claude Code?

Run this command in your terminal: claude mcp add bruster -- npx -y https://github.com/aliilyas/bruster/releases/download/v0.3.2/bruster-0.3.2.mcpb

### What are the best alternatives to Bruster?

The closest alternatives to Bruster are Browser Use, Scrapling MCP Server, Oya Browser, Mantis and Auto-building agents.

## Alternatives

- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.
- [Auto-building agents](https://ai-powered.com/mcp/auto-building-agents): Auto-building agents is a paid MCP server for browser automation.
- [pour](https://ai-powered.com/mcp/pour): pour is an open-source MCP server for developer tools.
- [AgentFarm](https://ai-powered.com/mcp/agentfarm): AgentFarm is a freemium MCP server for browser automation.
- [OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved](https://ai-powered.com/mcp/openadapt-your-agent-decides-openadapt-enters-it-and-checks): OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved is an open-source MCP server for browser automation.

---
Source: https://ai-powered.com/mcp/bruster
