mirror of https://github.com/AgentDeskAI/browser-tools-mcp.git synced 2025-06-27 00:41:26 +00:00

History

Emil Neander f4cb92b2a7 Refactor browser connection and config with new Puppeteer service

- Replace browser-utils.ts with a more robust puppeteer-service.ts
- Improve browser detection
- Improve cross-platform browser executable path detection

2025-03-06 11:58:25 +01:00

lighthouse

Refactor browser connection and config with new Puppeteer service

2025-03-06 11:58:25 +01:00

browser-connector.ts

Refactor browser connection and config with new Puppeteer service

2025-03-06 11:58:25 +01:00

package-lock.json

2025-02-14 04:18:43 -05:00

package.json

Refactor browser connection and config with new Puppeteer service

2025-03-06 11:58:25 +01:00

puppeteer-service.ts

Refactor browser connection and config with new Puppeteer service

2025-03-06 11:58:25 +01:00

README.md

Add Lighthouse audit documentation to README files

2025-02-26 18:43:55 +01:00

tsconfig.json

Merge remote-tracking branch 'upstream/staging' into mirror-staging

2025-03-05 22:54:40 +01:00

README.md

Browser Tools Server

A powerful browser tools server for capturing and managing browser events, logs, and screenshots. This server works in conjunction with the Browser Tools Chrome Extension to provide comprehensive browser debugging capabilities.

Features

Console log capture
Network request monitoring
Screenshot capture
Element selection tracking
WebSocket real-time communication
Configurable log limits and settings
Lighthouse-powered accessibility and performance audits

Prerequisites

Node.js 14 or higher
Chrome or Chromium browser installed (required for audit functionality)

Installation

npx @agentdeskai/browser-tools-server

Or install globally:

npm install -g @agentdeskai/browser-tools-server

Usage

Start the server:

npx @agentdeskai/browser-tools-server

The server will start on port 3025 by default
Install and enable the Browser Tools Chrome Extension
The server exposes the following endpoints:

/console-logs - Get console logs
/console-errors - Get console errors
/network-errors - Get network error logs
/network-success - Get successful network requests
/all-xhr - Get all network requests
/screenshot - Capture screenshots
/selected-element - Get currently selected DOM element
/accessibility-audit - Run accessibility audit on current page
/performance-audit - Run performance audit on current page

API Documentation

GET Endpoints

GET /console-logs - Returns recent console logs
GET /console-errors - Returns recent console errors
GET /network-errors - Returns recent network errors
GET /network-success - Returns recent successful network requests
GET /all-xhr - Returns all recent network requests
GET /selected-element - Returns the currently selected DOM element

POST Endpoints

POST /extension-log - Receive logs from the extension
POST /screenshot - Capture and save screenshots
POST /selected-element - Update the selected element
POST /wipelogs - Clear all stored logs
POST /accessibility-audit - Run a WCAG-compliant accessibility audit on the current page
POST /performance-audit - Run a performance audit on the current page

Audit Functionality

The server provides Lighthouse-powered audit capabilities for accessibility and performance testing:

Accessibility Audit

Runs a WCAG-compliant accessibility audit on the current page. The audit checks for common accessibility issues such as:

Color contrast problems
Missing alt text on images
Keyboard navigation issues
ARIA attribute problems
Form label issues

Performance Audit

Runs a performance audit on the current page to identify issues affecting load speed and responsiveness:

Render-blocking resources
Excessive DOM size
Unoptimized images
JavaScript execution time
First Contentful Paint (FCP) and other metrics

License

MIT