Skip to main content
Glama
Sign In
bwb-browser-termux

bwb-browser-termux

by krshforever
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

bwb-browser-termux

Browser Without Bloat — a lightweight browser automation MCP server using raw Chrome DevTools Protocol (CDP).

No Playwright. No Puppeteer. Just CDP.

Works on Termux/Android, Linux, macOS, and Windows.

Why bwb?

Feature

bwb

Playwright MCP

Puppeteer MCP

Dependencies

3 packages

50+ packages

30+ packages

Install size

~2MB

~500MB+

~300MB+

Works on Termux

✅

❌

❌

Works in CI

✅

⚠️ Needs browser download

⚠️ Needs browser download

Uses existing Chrome

✅

❌ Downloads its own

❌ Downloads its own

Related MCP server: tabby-mcp

Installation

npm install -g bwb-browser-termux

Or run directly:

npx bwb-browser-termux

Prerequisites

You need Chrome or Chromium installed. bwb will auto-detect it.

Termux/Android:

pkg install chromium

Linux (Debian/Ubuntu):

sudo apt install chromium-browser
# or
sudo apt install google-chrome

macOS:

brew install --cask google-chrome

Windows: Download and install Google Chrome normally.

Usage

With Claude Desktop / OpenCode / any MCP client

Add to your MCP client config:

{
  "mcpServers": {
    "bwb": {
      "command": "npx",
      "args": ["bwb-browser-termux"]
    }
  }
}

For Termux, you may need the full path:

{
  "mcpServers": {
    "bwb": {
      "command": "node",
      "args": ["/path/to/bwb-browser-termux/server.js"]
    }
  }
}

Command line

# Start the MCP server (stdio)
bwb

# With custom browser path
bwb --browser-path /usr/bin/chromium

# Custom CDP port
bwb --port 9333

# Visible browser (not headless)
bwb --headless false

# See all options
bwb --help

Configuration

CLI flag

Env var

Default

Description

--browser-path

BWB_CHROME_PATH

auto-detected

Path to Chrome/Chromium binary

--port

BWB_CDP_PORT

9222

Remote debugging port

--user-data-dir

BWB_USER_DATA_DIR

~/.cache/bwb-browser

Browser profile directory

--headless

BWB_HEADLESS

true

Run headless (true/false)

Tools (11)

Tool

Description

browser_goto

Navigate to a URL

browser_screenshot

Take a screenshot

browser_html

Get page/selector HTML

browser_text

Get page/selector text

browser_click

Click an element by CSS selector

browser_fill

Fill an input field

browser_elements

List interactive elements (links, buttons, inputs, headings)

browser_title

Get current page title

browser_url

Get current URL

browser_eval

Execute JavaScript in page context

browser_status

Browser connection status

License

MIT © krsh

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Chrome Tools MCP Server

      nicholmikey
      A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides tools for interacting with Chrome through its DevTools Protocol, enabling remote control of Chrome tabs to execute JavaScript, capture screenshots, monitor network traffic, and more.
      96 npm
      52
      MIT

    • mcp-chromium-cdp

      duquesnay
      A
      license
      A
      quality
      D
      maintenance
      MCP server for controlling Chromium/Chrome via Chrome DevTools Protocol. Supports cross-platform automation, auto-launch, and automatic reconnection.
      25
      1
      MIT