hrmeetsingh/mcp-browser-automation

12 stars 6 forks Quality 56 Trend 8MIT

Model Context Protocol based AI Agent that runs a browser from Claude desktop

Overview

This is demo project to practice Model Context Protocol based server implemenation for automating browsing with Playwright. It interacts with a Claude Desktop client to accept user prompts and use server to control browser. 1. Clone the repository: git clone https://github.com/hrmeetsingh/mcp-browser-automation.git 2. Install dependencies: npm install 3. Verify the output executables are present in dist folder 1. Create a configuration file in ~/Application\ Support/Claude/claude_desktop_config.json (This is for macOS) 2. Copy the following to the file: 1. Open Claude Desktop 2. Start a new conversation to open a browser and navigate to a URL - Navigating to a URL and doing actions with playwright

README

MCP Browser Automation

Pre-requisites

Building

Clone the repository: git clone https://github.com/hrmeetsingh/mcp-browser-automation.git
Install dependencies: npm install
Verify the output executables are present in dist folder

Integration

Create a configuration file in ~/Application\ Support/Claude/claude_desktop_config.json (This is for macOS)
Copy the following to the file:

{
  "mcpServers": {
    "mcp-browser-automation": {
      "command": "node",
      "args": ["/path/to/mcp-browser-automation/dist/index.js"]
    }
  }
}

Start Claude Desktop

Usage

Open Claude Desktop
Start a new conversation to open a browser and navigate to a URL

Example

Added MCP Server options
Navigating to a URL and doing actions with playwright

View the full README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "mcp-browser-automation": {
      "command": "node",
      "args": ["/path/to/mcp-browser-automation/dist/index.js"]
    }
  }
}