imprvhub/mcp-browser-agent

A powerful Model Context Protocol (MCP) integration that provides Claude Desktop with autonomous browser automation capabilities.
Features
- **Advanced Browser Automation**
- Navigate to any URL with customizable load strategies
- Capture full-page or element-specific screenshots
- Perform precise DOM interactions (click, fill, select, hover)
- Execute arbitrary JavaScript in browser context with console logs capture
- **Powerful API Client**
- Execute HTTP requests (GET, POST, PUT, PATCH, DELETE)
- Configure request headers and body content
- Process response data with JSON formatting
- Error handling with detailed feedback
- **MCP Resource Management**
- Access browser console logs as resources
- Retrieve screenshots through MCP resource interface
- Persistent session with headful browser instance
- **AI Agent Capabilities**
- Chain multiple browser operations for complex tasks
- Follow multi-step instructions with intelligent error recovery
- Technical task automation through natural language instructions
Demo
Timestamps:
Click on any timestamp to jump to that section of the video
**00:00** - **Google Search for MCP**
Navigation to Google homepage and search for "Model Context Protocol". Demonstration of Claude Desktop using the MCP integration to perform a basic web search and process the results.
**00:33** - **Screenshot Capture**
Taking a screenshot of the search results with a custom filename and showcasing it in Finder. Shows how Claude can capture and save visual content from web pages during browser automation.
**01:00** - **Wikipedia Search**
Navigation to Wikipedia.org and search for "Model Context Protocol". Illustrates Claude's ability to interact with different websites and their search functionality through the MCP integration.
**01:38** - **Dropdown Menu Interaction I**
Navigation to a test website (the-internet.herokuapp.com/dropdown) and selection of "Option 1" from a dropdown menu. Demonstrates Claude's capability to interact with form elements and make selections.
**01:56** - **Dropdown Menu Interaction II**
Changing the selection to "Option 2" from the same dropdown menu. Shows Claude's ability to manipulate the same form element multiple times and make different selections.
**02:09** - **Login Form Completion**
Navigation to a login page (the-internet.herokuapp.com/login) and filling in the username field with "tomsmith" and password field with "SuperSecretPassword!". Demonstrates form filling automation.
**02:28** - **Login Submission**
Submitting the login credentials and completing the authentication process. Shows Claude's ability to trigger form submissions and navigate through multi-step processes.
**02:36** - **API Request Execution**
Performing a GET request to JSONPlaceholder API endpoint. Demonstrates Claude's capability to make direct API calls and process the returned data through the MCP integration.
Requirements
- Node.js 20 or higher
- Claude Desktop
- A browser: Google Chrome, or one of Playwright's builds (see below)
Browser Support
The package supports the following browsers:
- Chrome (default)
- Firefox
- Microsoft Edge
- WebKit (Safari engine)
**Chrome** (the default) uses your installed Google Chrome. If Chrome is not installed, the
agent falls back to Playwright's own Chromium build and logs that it did.
Playwright's browsers are **not** downloaded on first use — install the ones you want once:
A clone followed by npm install downloads Chromium, Firefox and WebKit automatically through
the bundled @playwright/browser-* packages. Installing from Smithery or an MCPB bundle does
not, so run the command above for any browser other than Google Chrome.
> **macOS 13 (Ventura):** Playwright is pinned to 1.61, the last release that ships browsers
> for macOS 13; Playwright 1.62 dropped it. Google Chrome keeps working on any version.
> **Note about Safari**: Playwright doesn't provide direct support for Safari browser. Instead, it uses WebKit, which is the browser engine that powers Safari.
>
> **Note about Edge**: Selecting edge launches your installed Microsoft Edge (before 0.10.0 it silently opened plain Chromium). If Edge is not installed, the agent falls back to Playwright's Chromium. Technically, in Playwright, Edge is launched using the Chromium browser instance with the 'msedge' channel parameter because Microsoft Edge is based on Chromium.