MCP 服务器

Kaboom Browser AI Devtools MCP

MCP server for browser debugging, inspection, and verification that streams console logs, network errors, and user actions into AI coding assistants.

README

Branch Policy (Read First)

If you want something working, load code and run the server from STABLE. UNSTABLE makes zero promises on regressions or issues and is treated as work in progress. Stable builds are compressed, tagged, and moved to STABLE.

Kaboom is an AI debugger, inspector, and verification toolkit for local-first browser development workflows. Stream console logs, network failures, exceptions, recordings, and browser evidence into any MCP-compatible coding assistant.

Documentation • Quick Start • Features • MCP Setup

</div>

📦 Latest Release

Current version: v0.8.2 — Structured telemetry, session analytics, KaBOOM! branding, and contract-compliant metrics reporting.

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/brennhill/Kaboom-Browser-AI-Devtools-MCP/STABLE/scripts/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/brennhill/Kaboom-Browser-AI-Devtools-MCP/STABLE/scripts/install.ps1 | iex

</div>

Quick Start

Fire up Kaboom (binary + extension + auto-config) in one command:

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/brennhill/Kaboom-Browser-AI-Devtools-MCP/STABLE/scripts/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/brennhill/Kaboom-Browser-AI-Devtools-MCP/STABLE/scripts/install.ps1 | iex

This script automatically:

Downloads the latest stable binary for your platform.
Installs the browser extension files to ~/.kaboom/extension.
Auto-configures all detected MCP clients (Claude Code, Cursor, Windsurf, Zed, etc.).

Step 1: Finalize Browser Extension

Open chrome://extensions
Enable Developer mode (top right)
Click Load unpacked
Select the folder: ~/.kaboom/extension (or wherever the script printed)

Step 2: Restart Your AI Tool

Restart Claude Code, Cursor, Windsurf, or Zed. The Kaboom server will now start automatically when needed.

Full setup guide → | Per-tool install guide →

Why Teams Use Kaboom

No debug port required. Other tools need Chrome launched with --remote-debugging-port, which disables security sandboxing and breaks your normal browser workflow. Kaboom uses a standard extension, so your browser stays secure and unmodified.

Single binary, zero runtime. One Go binary that runs anywhere — no runtime dependencies, no Puppeteer, no framework.

Captures what others can't. WebSocket messages, full request/response bodies, user action recording, Web Vitals, automatic regression detection, visual annotations, and Playwright test generation from real browser sessions — features no other MCP browser tool offers.

Works with every MCP tool. Claude Code, Cursor, Windsurf, Zed, Claude Desktop, VS Code + Continue. Switch AI tools without changing your debugging setup.

Enterprise-safe by design. Binds to 127.0.0.1 only. Auth headers are stripped automatically. No accounts, no cloud. Anonymous usage stats only (see Privacy). Audit the source — it's AGPL-3.0.

What It Does

Console logs — console.log(), .warn(), .error() with full arguments
Network errors — Failed API calls (4xx, 5xx) with response bodies
Exceptions — Uncaught errors with full stack traces
WebSocket events — Connection lifecycle and message payloads
Network bodies — Request/response payloads for API debugging
User actions — Click, type, navigate, scroll recording with smart selectors
Web Vitals — LCP, CLS, INP, FCP with regression detection
DOM inspection — Query the page with CSS selectors via MCP
Accessibility audits — WCAG checks with SARIF export
Security audits — Credentials, PII, headers, cookies, third-party analysis
Browser automation — Click, type, select, upload, navigate with semantic selectors
Visual annotations — Draw mode for user feedback with computed style extraction
Test generation — Playwright tests from context, self-healing selectors, failure classification
Reproduction scripts — Playwright scripts from recorded user actions
Noise filtering — Auto-detect and dismiss irrelevant errors
Developer API — window.__kaboom.annotate() for custom context

Full feature list →

Privacy

All captured data (logs, network, actions) stays 100% local — nothing leaves your machine. No cloud, no accounts.

We collect anonymous usage statistics (tool call frequency, session duration, error rates) using a random install identifier not linked to your identity. No URLs, prompts, file contents, browsing data, or personal information is collected. Disable with KABOOM_TELEMETRY=off.

Privacy details →

Performance

See latest benchmarks for current performance data.

Last benchmarked: 2026-02-09 on darwin/arm64

Known Issues

See docs/core/known-issues.md for current known issues.

Development

make test                              # Go server tests
node --test tests/extension/*.test.js  # Extension tests
make dev                               # Build for current platform

Release process & quality gates → · Changelog →