gasoline-mcp 5.1.0

Gasoline MCP is an AI Debugger, Inspector, and Observability toolkit. It acts as Chrome DevTools for AI Agents using the Model Context Protocol (MCP).

Gasoline MCP

Browser observability for AI coding agents - autonomously debug and fix issues in real time.

Streams console logs, network errors, WebSocket events, and exceptions to Claude Code, Cursor, Windsurf, Claude Desktop, Zed, or any MCP-compatible assistant.

Installation

pip install gasoline-mcp

The correct platform-specific binary will be installed automatically.

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "gasoline": {
      "type": "stdio",
      "command": "gasoline-mcp",
      "args": ["--port", "7890", "--persist"]
    }
  }
}

With Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "gasoline": {
      "type": "stdio",
      "command": "gasoline-mcp",
      "args": ["--port", "7890", "--persist"]
    }
  }
}

Standalone

gasoline-mcp --port 7890

Chrome Extension

Install the Chrome extension to capture browser telemetry:

Chrome Web Store Link (coming soon)

Or load from source:

1. Download the extension from GitHub Releases
2. Go to chrome://extensions
3. Enable "Developer mode"
4. Click "Load unpacked" and select the extension/ folder

Features

• Console logs - All levels (log, warn, error, info, debug)
• Network requests - Full request/response capture with bodies
• WebSocket events - Real-time bidirectional message capture
• User actions - Clicks, navigation, form submissions
• Errors - Unhandled exceptions with stack traces
• Web Vitals - LCP, FID, CLS, INP, FCP, TTFB
• Accessibility audits - WCAG compliance scanning
• Security audits - CSP generation, third-party analysis
• AI Web Pilot - Execute JavaScript, highlight elements, manage state

Documentation

• Getting Started
• GitHub Repository
• Issue Tracker

Privacy

100% local. No cloud, no analytics, no telemetry. Logs never leave your machine.

License

AGPL-3.0 — Free for personal and internal company use. Commercial licensing available for proprietary integration.