Browser Automation MCP Server: Streamline Workflows & Boost Efficiency

What is Browser Automation MCP Server: Streamline Workflows & Boost Efficiency?

Browser Automation MCP Server is a tool designed to integrate browser automation capabilities with AI assistants like Claude. By acting as a middleware, it enables programs to interact with web browsers programmatically—handling tasks like form submissions, data extraction, and element manipulation. This server follows the Model Context Protocol (MCP), allowing seamless collaboration with compatible AI systems to automate repetitive online tasks efficiently.

How to use Browser Automation MCP Server: Streamline Workflows & Boost Efficiency?

Start by cloning the repository and installing dependencies via npm. Configure the server in your MCP setup with specific paths and ports. Once running, you can send commands to navigate pages, click elements, or extract data. For example, initiating a workflow might involve navigating to a URL, filling forms with the type tool, and saving screenshots for verification. The server’s modular design lets you chain actions to create end-to-end processes.

Key Features of Browser Automation MCP Server: Streamline Workflows & Boost Efficiency?

Beyond basic automation, this server stands out with features like real-time screenshot capture (full-page or viewport), intelligent element interaction (waiting for selectors to load), and flexible data extraction via CSS selectors. It also supports custom JavaScript execution through the evaluate tool, letting you tailor interactions to complex web applications. Whether scraping dynamic content or automating login flows, these tools reduce manual intervention while maintaining reliability.

Use cases of Browser Automation MCP Server: Streamline Workflows & Boost Efficiency?

FAQ from Browser Automation MCP Server: Streamline Workflows & Boost Efficiency?

Q: Does it work with all browsers?
A: Yes, via Playwright’s support for Chrome, Firefox, and Safari. Choose the browser in config settings.

Q: Can I customize timeout durations?
A: Most actions let you set timeouts, like adjusting waitForSelector delays to handle slow-loading elements.

Q: What if the server crashes mid-task?
A: Implement error-handling logic in your scripts and use tools like PM2 for process management to restart automatically.

Browser Automation MCP Server

A Model Context Protocol (MCP) server that provides browser automation capabilities for Claude and other MCP-compatible AI assistants.

Features

• Web Automation : Control web browsers programmatically
• Screenshot Capture : Take screenshots of web pages
• Element Interaction : Click, type, and interact with web elements
• Navigation : Navigate between pages and manage browser state
• Form Filling : Automate form filling and submission
• Data Extraction : Extract data from web pages

Installation

# Clone the repository
git clone https://github.com/samihalawa/browser-automation-server.git
cd browser-automation-server

# Install dependencies
npm install

# Build the server
npm run build

Usage

Starting the Server

npm start

Configuration

Add the server to your MCP configuration:

{
  "servers": {
    "browser-automation": {
      "command": "/path/to/node",
      "args": ["/path/to/browser-automation-server/build/index.js"],
      "enabled": true,
      "port": 3008,
      "environment": {
        "NODE_PATH": "/path/to/node_modules",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Available Tools

navigate

Navigate to a URL.

Parameters:

• url (string, required): URL to navigate to
• waitUntil (string, optional): Navigation wait condition. Options: 'load', 'domcontentloaded', 'networkidle'. Default: 'load'

screenshot

Take a screenshot of the current page.

Parameters:

• fullPage (boolean, optional): Whether to capture full page or just viewport. Default: false
• path (string, optional): Path to save the screenshot to. If not provided, returns base64 encoded image

click

Click on an element.

Parameters:

• selector (string, required): CSS selector of the element to click
• waitForSelector (boolean, optional): Whether to wait for the selector to appear. Default: true

type

Type text into an input field.

Parameters:

• selector (string, required): CSS selector of the input element
• text (string, required): Text to type
• delay (number, optional): Delay between keystrokes in milliseconds. Default: 0

extract

Extract data from the page.

Parameters:

• selector (string, required): CSS selector of the elements to extract
• attribute (string, optional): Attribute to extract. If not provided, extracts text content

evaluate

Evaluate JavaScript in the browser context.

Parameters:

• script (string, required): JavaScript code to evaluate
• args (array, optional): Arguments to pass to the script

Example Usage

1. Navigate to a website:

   navigate(url: "https://example.com")

2. Take a screenshot:

   screenshot(fullPage: true)

3. Click a button:

   click(selector: "#submit-button")

4. Fill a form:

   type(selector: "#username", text: "user123")

type(selector: "#password", text: "password123")
click(selector: "#login-button")

5. Extract data:

   extract(selector: ".product-title", attribute: "innerText")

Requirements

• Node.js 14+
• Playwright for browser automation

License

MIT