Metadata-Version: 2.4
Name: gasoline-mcp
Version: 6.0.3
Summary: Gasoline MCP is an AI Debugger, Inspector, and Observability toolkit. It acts as Chrome DevTools for AI Agents using the Model Context Protocol (MCP).
Author-email: Brennan Hill <noreply@cookwithgasoline.com>
License: AGPL-3.0-only
Project-URL: Homepage, https://cookwithgasoline.com
Project-URL: Documentation, https://cookwithgasoline.com/getting-started/
Project-URL: Repository, https://github.com/brennhill/gasoline-mcp-ai-devtools
Project-URL: Issues, https://github.com/brennhill/gasoline-mcp-ai-devtools/issues
Keywords: mcp,mcp-server,ai-debugging,ai-observability,llm-ops,devtools,prompt-engineering,agent-inspection
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: darwin-arm64
Requires-Dist: gasoline-mcp-darwin-arm64==6.0.1; extra == "darwin-arm64"
Provides-Extra: darwin-x64
Requires-Dist: gasoline-mcp-darwin-x64==6.0.1; extra == "darwin-x64"
Provides-Extra: linux-arm64
Requires-Dist: gasoline-mcp-linux-arm64==6.0.1; extra == "linux-arm64"
Provides-Extra: linux-x64
Requires-Dist: gasoline-mcp-linux-x64==6.0.1; extra == "linux-x64"
Provides-Extra: win32-x64
Requires-Dist: gasoline-mcp-win32-x64==6.0.1; extra == "win32-x64"

# 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

```bash
pip install gasoline-mcp
```

The correct platform-specific binary will be installed automatically.

## Usage

### With Claude Desktop

Add to your `claude_desktop_config.json`:

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

### With Claude Code

Add to your `.mcp.json`:

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

### Standalone

```bash
gasoline-mcp --port 7890
```

## Chrome Extension

Install the Chrome extension to capture browser telemetry:

[Chrome Web Store Link](https://chrome.google.com/webstore) (coming soon)

Or load from source:
1. Download the extension from [GitHub Releases](https://github.com/brennhill/gasoline-mcp-ai-devtools/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](https://cookwithgasoline.com/getting-started/)
- [GitHub Repository](https://github.com/brennhill/gasoline-mcp-ai-devtools)
- [Issue Tracker](https://github.com/brennhill/gasoline-mcp-ai-devtools/issues)

## 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](https://cookwithgasoline.com/privacy/) for proprietary integration.
