This project provides a suite of browser auditing and monitoring tools for AI agents, enabling them to interact with and analyze web pages directly from IDEs like Cursor. It targets developers and AI engineers seeking to enhance their AI coding assistants with real-time browser context and analysis capabilities, offering automated checks for accessibility, performance, SEO, and best practices.

How It Works

The system comprises three components: a Chrome extension for capturing browser data (logs, DOM, screenshots), a Node.js server acting as middleware, and an MCP (Model Context Protocol) server integrated into the IDE. This architecture allows AI clients to send commands to the Node.js server via the MCP server, which then instructs the Chrome extension to perform actions like running audits or capturing specific data. Puppeteer and the Lighthouse library are leveraged for headless browser automation and detailed page analysis.

Quick Start & Requirements

• Install Chrome Extension: v1.2.0 BrowserToolsMCP Chrome Extension
• Install MCP Server: npx @agentdeskai/browser-tools-mcp@latest
• Run Node Server: npx @agentdeskai/browser-tools-server@latest
• Requires Chrome browser and Node.js.
• Full setup guide: BrowserTools MCP Docs

Highlighted Details

• Integrates Lighthouse for WCAG compliance, performance, SEO, and best practice audits.
• Supports Next.js specific audits.
• Offers "Debugger Mode" and "Audit Mode" for sequential tool execution.
• Includes auto-paste functionality for screenshots into Cursor.
• Resolves Windows connectivity issues and improves server/extension communication.

Maintenance & Community

• Project roadmap available on GitHub.
• Updates are regularly released (v1.2.0 noted).
• Community engagement encouraged via issue tickets and X (@tedx_ai).

Licensing & Compatibility

• License details are not explicitly stated in the README.
• Compatible with any MCP-compatible client, primarily designed for Cursor.

Limitations & Caveats

The auto-paste feature requires the Agent input field in Cursor to be focused. The README mentions two servers that need to be installed and run separately, which could be a point of confusion for new users.