Browser-use-claude-mcp

A browser automation MCP server for AI models like Claude and Gemini 2.5, enabling web browsing capabilities through natural language.

Overview

This project implements a Model Context Protocol (MCP) server that provides browser automation capabilities to AI models. It allows AI assistants to browse the web, interact with websites, and extract information using natural language commands.

Key Features

🌐 Browser Automation Features

Full browser automation (navigation, form filling, clicking, etc.)
Web search capabilities
Screenshot capture for visual understanding
Content extraction and analysis

🤖 AI Features

Support for multiple AI providers:
- Google Gemini 2.5 (primary focus)
- Anthropic Claude
- OpenAI
Image analysis (vision) capabilities
AI-powered content analysis

🔧 Technical Features

Written in TypeScript for maximum reliability
Modular architecture with clean separation of concerns
Comprehensive logging and error handling
Easy configuration through environment variables

Available Tools

| Tool Name | Description | |-----------|-------------| | browse_webpage | Navigate to a URL and extract its content | | search_web | Perform a web search and return results | | take_screenshot | Capture a screenshot of the current page | | click_element | Click on an element by text or selector | | fill_form | Fill out form fields with provided values | | extract_content | Extract specific content from a webpage | | analyze_content | AI-powered analysis of webpage content |

Getting Started

See INSTALL.md for detailed installation and setup instructions.

Quick Start

Clone the repository

git clone https://github.com/jasondsmith72/Browser-use-claude-mcp.git
cd Browser-use-claude-mcp

Install dependencies
```
npm install
```
Create a .env file (use .env.example as a template)
```
cp .env.example .env
```
Build the project
```
npm run build
```
Start the server
```
npm start
```

Configuration

The server can be configured through environment variables in your .env file:

# Browser configuration
CHROME_PATH=
CHROME_USER_DATA=
CHROME_DEBUGGING_PORT=9222

# AI provider (GEMINI, ANTHROPIC, OPENAI)
MCP_MODEL_PROVIDER=GEMINI

# API keys (use the one for your chosen provider)
GOOGLE_API_KEY=your_google_api_key_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here
OPENAI_API_KEY=your_openai_api_key_here

Using with Claude Desktop

Locate the Claude Desktop configuration file:
- Windows: %APPDATA%/Claude/claude_desktop_config.json
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add this MCP server to your configuration:

{
  "mcpServers": {
    "browser-use-claude-mcp": {
      "command": "node",
      "args": [
        "/path/to/Browser-use-claude-mcp/dist/index.js"
      ],
      "env": {
        "CHROME_PATH": "",
        "CHROME_USER_DATA": "",
        "MCP_MODEL_PROVIDER": "GEMINI",
        "GOOGLE_API_KEY": "your_google_api_key_here"
      }
    }
  }
}

Restart Claude Desktop for the changes to take effect.

Examples

Basic Web Browsing

browse_webpage(url="https://example.com")

Web Search

search_web(query="best programming languages 2025")

Filling a Form

fill_form(fields={
  "name": "John Doe",
  "email": "[email protected]",
  "message": "Hello world!"
}, submit=true)

AI Content Analysis

analyze_content(
  url="https://en.wikipedia.org/wiki/Artificial_intelligence",
  instructions="Summarize the key developments in AI in the last decade"
)

Development

# Run in development mode
npm run dev

# Run tests
npm test

# Lint code
npm run lint

License

MIT

Credits

This project builds upon the work of browser-use and other MCP server implementations.