Browser Automation MCP server for AI agents

This MCP server, hyper-mcp-browser, provides browser integration capabilities with features for page summarization and search functionality through Google and Bing.

Installation

You can easily install hyper-mcp-browser using npx:

npx -y hyper-mcp-browser

Configuration Options

The server behavior can be customized through environment variables:

Browser Connection Settings

Hyper_browserURL: Specifies the remote debugging port URL for connecting to the browser
```
Default: "http://localhost:9222"
```
Hyper_isAutoLauncher: Controls whether to use a local browser or connect to an existing one
```
Default: true (Set to "false" to use remote debugging port instead)
```

CHROME_PATH: Optional path to the Chrome executable

Default: Auto-detected (Chrome Canary if available, otherwise Chrome stable)

userDataDir: Custom user data directory for Chrome
```
Default: undefined
```

Content and Search Settings

Hyper_SEARCH_ENGINE: Search engine selection
```
Default: "google" (Alternatives: "bing")
```

Hyper_startingUrl: Initial URL to load when starting

Default: "https://github.com/BigSweetPotatoStudio/HyperChat"

Usage Examples

Basic Usage

To start with default settings:

npx -y hyper-mcp-browser

Custom Search Engine

To use Bing instead of Google:

Hyper_SEARCH_ENGINE=bing npx -y hyper-mcp-browser

Connect to Existing Browser

To connect to a browser already running with remote debugging:

Hyper_isAutoLauncher=false Hyper_browserURL=http://localhost:9222 npx -y hyper-mcp-browser

Custom Starting Page

Hyper_startingUrl="https://example.com" npx -y hyper-mcp-browser

Using with Custom Chrome Installation

CHROME_PATH="/path/to/chrome" npx -y hyper-mcp-browser

Integration with HyperChat

For integration with HyperChat, you can download it from: https://github.com/BigSweetPotatoStudio/HyperChat

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "hyper-mcp-browser" '{"command":"npx","args":["-y","hyper-mcp-browser"],"env":{"Hyper_browserURL":"http://localhost:9222","Hyper_isAutoLauncher":"true","Hyper_SEARCH_ENGINE":"google","Hyper_startingUrl":"https://github.com/BigSweetPotatoStudio/HyperChat"}}'

See the official Claude Code MCP documentation for more details.

For 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 > Tools & Integrations and click "New MCP Server".

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

{
    "mcpServers": {
        "hyper-mcp-browser": {
            "command": "npx",
            "args": [
                "-y",
                "hyper-mcp-browser"
            ],
            "env": {
                "Hyper_browserURL": "http://localhost:9222",
                "Hyper_isAutoLauncher": "true",
                "Hyper_SEARCH_ENGINE": "google",
                "Hyper_startingUrl": "https://github.com/BigSweetPotatoStudio/HyperChat"
            }
        }
    }
}

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 explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "hyper-mcp-browser": {
            "command": "npx",
            "args": [
                "-y",
                "hyper-mcp-browser"
            ],
            "env": {
                "Hyper_browserURL": "http://localhost:9222",
                "Hyper_isAutoLauncher": "true",
                "Hyper_SEARCH_ENGINE": "google",
                "Hyper_startingUrl": "https://github.com/BigSweetPotatoStudio/HyperChat"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect