​
Prerequisites

  • Node.js 20.12.0 or higher
  • npm (comes with Node.js)
  • For CDP mode: Chromium with remote debugging enabled
  • For launch mode: Playwright browser binaries

​
Install from npm

npm install browser-jet-pilot

​
Install from source

Clone the repository and install dependencies: 
git clone https://github.com/0xABADBABE-ops/browser-jet-pilot.git
cd browser-jet-pilot
npm install

​
Build

Build TypeScript to JavaScript: 
npm run build
This compiles the source from src/ to dist/ and prepares the project for execution.

​
Playwright browsers (launch mode)

When using LAUNCH=true, Playwright needs browser binaries installed: 
npx playwright install chromium

​
Verify installation

Run the built server: 
# Stdio mode
node dist/index.js

# HTTP mode
node dist/index.js --port 3100 --host 0.0.0.0

​
Claude Desktop configuration

For Claude Desktop integration, add to your claude_desktop_config.json: Config file locations by platform:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "browser": {
      "command": "node",
      "args": ["/absolute/path/to/browser-jet-pilot/dist/index.js"],
      "env": {
        "CDP_URL": "http://localhost:9222"
      }
    }
  }
}

​
Binaries

After building, the package provides two binaries:
  • browser-jet-pilot - Main MCP server
  • bjp-agent - BrowserAgent CLI
These are available globally if you install with npm install -g or locally via npm run agent.

​
Development dependencies

The project includes several development tools:
  • typescript: TypeScript compiler
  • vitest: Testing framework with UI mode
  • eslint: Linting
  • prettier: Code formatting
  • husky + lint-staged: Pre-commit hooks
All are installed automatically via npm install.