MCP server integrating with Vercel's agent-browser for AI-driven browser automation
npm install @nxavis/agent-browser-mcp


A Model Context Protocol (MCP) server that provides browser automation capabilities through Vercel's agent-browser. This enables LLMs to interact with web pages using a fast Rust CLI with Node.js fallback.
``bash1. Install agent-browser CLI
npm install -g agent-browser && agent-browser install
Then use tools like
browser_navigate, browser_click, browser_snapshot to control the browser from your AI agent.Features
- AI-Optimized Browser Control - Semantic element locators using accessibility properties, text matching, and data attributes
- Session Isolation - Multiple isolated browser sessions with separate cookies, storage, and navigation history
- Comprehensive Automation - Navigation, form filling, clicking, scrolling, keyboard input, and more
- Data Extraction - Get text, HTML, attributes, accessibility snapshots, screenshots, and PDFs
- Cookie Management - Full control over browser cookies and storage
- JavaScript Execution - Run arbitrary scripts in the browser context
- Network Inspection - Monitor console messages and network requests
Installation
`bash
npm install @nxavis/agent-browser-mcp
`Or run directly with npx:
`bash
npx @nxavis/agent-browser-mcp
`$3
- Node.js 18 or newer
- agent-browser CLI installed:
`bash
Install agent-browser globally
npm install -g agent-browserDownload Chromium browser
agent-browser installOn Linux, install system dependencies if needed:
agent-browser install --with-deps
`> ⚠️ Windows Note: agent-browser currently has known issues on Windows with native shells (PowerShell/CMD). For Windows users, we recommend using WSL (Windows Subsystem for Linux) until the upstream issue is resolved.
Configuration
$3
Add to your
claude_desktop_config.json:macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json`json
{
"mcpServers": {
"agent-browser": {
"command": "npx",
"args": ["@nxavis/agent-browser-mcp"]
}
}
}
`$3
Add to your VS Code settings (JSON):
`json
{
"mcp": {
"servers": {
"agent-browser": {
"command": "npx",
"args": ["@nxavis/agent-browser-mcp"]
}
}
}
}
`$3
Add to your
.mcp.json file in your project root or home directory:`json
{
"mcpServers": {
"agent-browser": {
"command": "npx",
"args": ["@nxavis/agent-browser-mcp"]
}
}
}
`Or use the global configuration at
~/.mcp.json:`json
{
"mcpServers": {
"agent-browser": {
"command": "npx",
"args": ["@nxavis/agent-browser-mcp"],
"env": {
"AGENT_BROWSER_PATH": "/usr/local/bin/agent-browser"
}
}
}
}
`$3
If
agent-browser is not in your PATH, specify its location:`json
{
"mcpServers": {
"agent-browser": {
"command": "npx",
"args": ["@nxavis/agent-browser-mcp"],
"env": {
"AGENT_BROWSER_PATH": "/path/to/agent-browser"
}
}
}
}
`Available Tools
$3
-
browser_navigate - Navigate to a URL
- browser_go_back - Navigate back in browser history
- browser_go_forward - Navigate forward in browser history
- browser_reload - Reload the current page$3
-
browser_click - Click on an element
- browser_fill - Fill a text input field
- browser_type - Type text character by character
- browser_hover - Hover over an element
- browser_scroll - Scroll the page or a specific element
- browser_select - Select an option from a dropdown
- browser_check - Check a checkbox or radio button
- browser_uncheck - Uncheck a checkbox
- browser_press - Press a keyboard key$3
-
browser_get_text - Get text content from an element or page
- browser_get_html - Get HTML content
- browser_get_attribute - Get an attribute value
- browser_get_url - Get the current page URL
- browser_get_title - Get the current page title
- browser_snapshot - Get accessibility tree snapshot$3
-
browser_new_session - Create a new isolated browser session
- browser_close_session - Close a browser session$3
-
browser_screenshot - Take a screenshot
- browser_pdf - Generate a PDF of the current pageFor a complete list of tools and their parameters, see the original documentation.
Development
`bash
Clone the repository
git clone https://github.com/nxavis/agent-browser-mcp.git
cd agent-browser-mcpInstall dependencies
npm installBuild
npm run buildRun tests
npm testWatch mode
npm run dev
``MIT
This package is based on agent-browser-mcp by minhlucvan, adapted for the @nxavis ecosystem.