README.md•2.14 kB
# Browser Tools MCP Server
A Model Context Protocol (MCP) server that provides AI-powered browser tools integration. This server works in conjunction with the Browser Tools Server to provide AI capabilities for browser debugging and analysis.
## Features
- MCP protocol implementation
- Browser console log access
- Network request analysis
- Screenshot capture capabilities
- Element selection and inspection
- Real-time browser state monitoring
- Accessibility, performance, SEO, and best practices audits
## Prerequisites
- Node.js 14 or higher
- Browser Tools Server running
- Chrome or Chromium browser installed (required for audit functionality)
## Installation
```bash
npx @agentdeskai/browser-tools-mcp
```
Or install globally:
```bash
npm install -g @agentdeskai/browser-tools-mcp
```
## Usage
1. First, make sure the Browser Tools Server is running:
```bash
npx @agentdeskai/browser-tools-server
```
2. Then start the MCP server:
```bash
npx @agentdeskai/browser-tools-mcp
```
3. The MCP server will connect to the Browser Tools Server and provide the following capabilities:
- Console log retrieval
- Network request monitoring
- Screenshot capture
- Element selection
- Browser state analysis
- Accessibility and performance audits
## MCP Functions
The server provides the following MCP functions:
- `mcp_getConsoleLogs` - Retrieve browser console logs
- `mcp_getConsoleErrors` - Get browser console errors
- `mcp_getNetworkErrors` - Get network error logs
- `mcp_getNetworkSuccess` - Get successful network requests
- `mcp_getNetworkLogs` - Get all network logs
- `mcp_getSelectedElement` - Get the currently selected DOM element
- `mcp_runAccessibilityAudit` - Run a WCAG-compliant accessibility audit
- `mcp_runPerformanceAudit` - Run a performance audit
- `mcp_runSEOAudit` - Run an SEO audit
- `mcp_runBestPracticesAudit` - Run a best practices audit
## Integration
This server is designed to work with AI tools and platforms that support the Model Context Protocol (MCP). It provides a standardized interface for AI models to interact with browser state and debugging information.
## License
MIT