<div align="center"> <br /> <img src="assets/logo.svg" alt="LCBro Logo" width="300" height="225"> <br /> <br />

LCBro

Low Cost Browser Remote Operations

The Cool Browser Automation MCP Server

<br />

Lightning Fast Zero Config Production Ready

<br /> </div>

LCBro is a powerful MCP server for browser automation with support for both Playwright and Chrome DevTools Protocol (CDP). It provides intelligent preprocessing, comprehensive logging, and remote browser management capabilities.

** Cost Optimization Focus**: This project is specifically designed to optimize LLM request costs and reduce context usage by intelligently preprocessing and cleaning data using local LLM models before sending to expensive main LLM APIs. This approach can reduce costs by up to 80% while improving result quality.

Features

<table> <tr> <td width="50%">

Browser Automation

• Real browser control with JavaScript execution
• Login flows, clicks, text input, form handling
• Screenshot capture and content extraction
• Session management with persistent contexts

Intelligent Preprocessing

• Auto-generates preprocessing prompts
• Local LLM integration (Ollama, JAN)
• Smart content analysis and optimization
• Cost-efficient data preparation

</td> <td width="50%">

Multiple Engines

• Playwright: Full-featured automation
• CDP: Chrome DevTools Protocol support
• Remote browser connections
• Auto-detection and fallback

Advanced Logging

• Comprehensive LLM interaction logs
• Performance metrics and token tracking
• Configurable log rotation and compression
• Debug and monitoring capabilities

</td> </tr> </table>

Quick Start

Use with npx (Recommended - No Installation)

# Use directly without installation
npx lcbro

# With custom configuration
npx lcbro --config /path/to/config.yaml --port 3000

Global Installation

# Install globally via npm
npm install -g lcbro

# Start the server
lcbro

Local Development

# Clone and install
git clone https://github.com/lcbro/lcbro.git
cd lcbro
npm install
npm run build
npm start

Docker

# Run with Docker
docker run -p 3000:3000 lcbro:latest

Usage Examples

Basic Browser Automation

# Navigate and extract content
npx lcbro navigate --url "https://example.com"
npx lcbro extract --format text

With Custom Configuration

# Enable CDP support
npx lcbro --cdp-enabled --port 3001

# Custom logging directory
npx lcbro --logs-dir "/custom/logs" --log-level debug

MCP Client Integration

{
  "mcpServers": {
    "lcbro": {
      "command": "npx",
      "args": ["-y", "lcbro"]
    }
  }
}

Installation

Prerequisites

• Node.js 18+
• npm or yarn
• Chrome/Chromium browser (for CDP support)

Global Installation (Recommended)

# Install globally
npm install -g lcbro

# Verify installation
lcbro --version

Local Development

# Clone repository
git clone https://github.com/lcbro/lcbro.git
cd lcbro

# Install dependencies
npm install

# Build project
npm run build

# Install Playwright browsers
npm run install:browsers

Configuration

LCBro uses YAML configuration files with CLI overrides. Create a config/default.yaml file or use CLI options:

Basic Configuration

server:
  host: "localhost"
  port: 3000

browser:
  engine: playwright  # playwright | cdp
  headless: true
  defaultTimeoutMs: 30000
  maxContexts: 8
  storageDir: /data/profiles

llm:
  defaultModel: "ollama:llama3.1"
  maxOutputTokens: 2000
  temperature: 0
  host: "localhost"
  port: 11434
  janPort: 1337
  autoPreprocess: true

security:
  allowDomains: ["example.com", "gov.br"]
  blockPrivateNetworks: true

CLI Configuration Overrides

# Server settings
lcbro --port 3001 --host 0.0.0.0

# CDP browser support
lcbro --cdp-enabled --cdp-port 9222

# Remote CDP server
lcbro --remote-url https://cdp.example.com:9222 --remote-ssl-mode enabled

# Logging configuration
lcbro --log-level debug --logs-dir /tmp/lcbro-logs

CLI Usage

LCBro provides a comprehensive command-line interface:

Main Commands

# Start the server
lcbro

# Show help
lcbro --help

# Show current configuration
lcbro config

# Launch browsers with CDP
lcbro browser:launch -b chrome -p 9222

# Manage log files
lcbro logs --command summary

# Test remote CDP connection
lcbro test:remote -u https://cdp.example.com:9222

Environment Variables

LCBro supports configuration via environment variables:

LLM Configuration

# Local LLMs (Recommended)

#### Ollama (free, no API keys required)
```bash
# Install Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Pull a model
ollama pull llama3.1

# Configure LCBro
export LLM_HOST=localhost
export LLM_PORT=11434
export LLM_DEFAULT_MODEL=ollama:llama3.1

JAN AI (free, with optional API key)

# Configure LCBro for JAN AI
…