browser-tools-mcp
v1.2.1
Published
MCP (Model Context Protocol) server for browser tools integration
Downloads
294
Maintainers
Readme
Browser Tools MCP Server (Node.js 16 Fork)
Note: This is a forked repository that provides Node.js 16 compatibility for the original 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.
About This Fork
This fork was created to provide compatibility with Node.js 16 environments. The original repository requires Node.js 14 or higher, but some specific dependencies may have issues with Node 16. This variation:
- Ensures all dependencies work properly with Node.js 16
- Maintains the same functionality as the original package
If you're specifically working in a Node.js 16 environment, this fork is recommended over the original package.
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 16
- Browser Tools Server running
- Chrome or Chromium browser installed (required for audit functionality)
Installation
npx browser-tools-mcpOr install globally:
npm install -g browser-tools-mcpUsage
- First, make sure the Browser Tools Server is running:
npx @agentdeskai/browser-tools-server- Then start the MCP server:
npx browser-tools-mcp- 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 logsmcp_getConsoleErrors- Get browser console errorsmcp_getNetworkErrors- Get network error logsmcp_getNetworkSuccess- Get successful network requestsmcp_getNetworkLogs- Get all network logsmcp_getSelectedElement- Get the currently selected DOM elementmcp_runAccessibilityAudit- Run a WCAG-compliant accessibility auditmcp_runPerformanceAudit- Run a performance auditmcp_runSEOAudit- Run an SEO auditmcp_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
