Browser Use Claude MCP

🚀 Browser Use Claude MCP

An MCP server for browser automation of AI models like Claude and Gemini 2.5, providing web browsing capabilities through natural language instructions.

🚀 Quick Start

Refer to INSTALL.md for detailed installation and setup instructions.

Quick Start Guide

1. Clone the repository

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

2. Install dependencies

npm install

3. Create a .env file (using .env.example as a template)

cp .env.example .env

4. Build the project

npm run build

5. Start the server

npm start

✨ Features

🌐 Browser Automation Features

• Full browser automation capabilities (navigation, form filling, clicking, etc.)
• Web search functionality
• Page screenshots for visual understanding
• Content extraction and analysis

🤖 AI-related Features

• Support for multiple AI providers:
  • Google Gemini 2.5 (Main support)
  • Anthropic Claude
  • OpenAI
• Image analysis (visual processing)
• AI-driven content analysis

🔧 Technical Features

• Written in TypeScript for reliability
• Modular architecture with clear separation of responsibilities
• Comprehensive logging and error handling
• Simple and easy-to-use environment variable configuration

📦 Available Tools

📚 Documentation

Configuration

Refer to the .env.example file for configuration via environment variables. For example:

• CHROME_PATH: Specify the path to the Chrome browser
• HEADLESS_CHROME: Whether to enable headless mode (true/false)

Using with Claude Desktop

To use this project with Claude Desktop, follow these steps:

1. Open the configuration file, usually located at ~/.config/claude/settings.json
2. Add the MCP server configuration:

{
  "mcpServers": [
    {
      "name": "Browser Use Claude",
      "url": "http://localhost:3000"
    }
  ]
}

3. Start Claude Desktop and select the newly added MCP server

💻 Usage Examples

Basic Usage

// Example: Visit Google
await browserUseClaude.browseWeb('https://www.google.com');

Advanced Usage

// Example: Search for "Artificial Intelligence"
await browserUseClaude.searchWeb('Artificial Intelligence');

🔧 Technical Details

Development and Testing

1. Run in development mode

npm run dev

2. Execute tests

npm test

3. Run the Linter to check code style

npm run lint

📄 License

This project is licensed under the MIT License.

Acknowledgments

Thanks to the community and open-source projects for their contributions, which made this project possible.