Browser Use MCP server

MCP-browser-use is a server that connects MCP clients (like Claude or Cursor) with browser functionality through the browser-use library. It allows your AI assistant to interact with web content without requiring you to pay for an additional LLM API key - it simply leverages the LLM already configured in your MCP client.

Installation

To use mcp-browser-use, you need to install it first. The easiest way is through pip:

pip install mcp-browser-use

For the latest version, you can install it directly from GitHub:

pip install git+https://github.com/vinayak-mehta/mcp-browser-use.git

You'll also need to have uvx installed, which is part of the Universal Vertex (uv) ecosystem:

pip install uvx

Usage

Basic Configuration

To connect mcp-browser-use with an MCP client, add the following command to your client's configuration:

uvx mcp-browser-use

Using Full Paths

To prevent the MCP client from failing to start the server, it's recommended to use the full path to the uvx executable:

/path/to/uvx mcp-browser-use

You can find the full path to uvx using:

which uvx

Client-Specific Setup

Claude

For Anthropic's Claude:

1. Go to settings in the Claude interface
2. Navigate to the MCP section
3. Enter the command:

   /full/path/to/uvx mcp-browser-use
   

4. Save the configuration

Cursor

For Cursor IDE:

1. Open settings in Cursor
2. Find the AI/MCP configuration section
3. Add the following command:

   /full/path/to/uvx mcp-browser-use
   

4. Apply the changes

Once configured, your AI assistant will be able to browse the web and interact with web content when requested.

Troubleshooting

Common Issues

If you encounter errors when starting the MCP server:

• Ensure uvx is properly installed
• Try using the full path to the uvx executable
• Check that mcp-browser-use is installed correctly
• Verify your internet connection

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.