What is Hyperbrowser MCP Server

The Hyperbrowser MCP Server is a tool designed to facilitate web scraping, data extraction, and webpage crawling. It offers users the ability to access various general-purpose browser agents in a seamless manner, enabling automated interactions with web content.

Use cases

Common use cases include scraping web pages for specific data formats, crawling linked websites to gather structured content, searching the internet via Bing, and utilizing AI agents for complex automation tasks. This server is particularly beneficial for applications requiring structured data extraction from unstructured HTML.

How to use

To use the Hyperbrowser MCP Server, users must first install it using the command ‘npx hyperbrowser-mcp ’. Alternatively, it can be configured in applications like Cursor and Windsurf by specifying command parameters in the respective configuration files. Developers can also run the server from the source after cloning the repository and installing dependencies.

Key features

The server boasts several key features, including tools for scraping webpages, extracting structured data, searching the web with Bing, and general-purpose automation through different AI agents like OpenAI’s CUA and Anthropic’s Claude. Additionally, it offers profile management capabilities such as creating and deleting persistent profiles.

Where to use

The Hyperbrowser MCP Server can be utilized in various programming environments and applications that require web automation and data extraction. It’s particularly suited for developers and data analysts who need to interact with web content programmatically, making it useful in data science, research, and application development.

Hyperbrowser MCP Server

This is Hyperbrowser’s Model Context Protocol (MCP) Server. It provides various tools to scrape, extract structured data, and crawl webpages. It also provides easy access to general purpose browser agents like OpenAI’s CUA, Anthropic’s Claude Computer Use, and Browser Use.

More information about the Hyperbrowser can be found here. The hyperbrowser API supports a superset of features present in the mcp server.

More information about the Model Context Protocol can be found here.

Table of Contents

• Installation
• Usage
• Tools
• Configuration
• License

Installation

Manual Installation

To install the server, run:

npx hyperbrowser-mcp <YOUR-HYPERBROWSER-API-KEY>

Running on Cursor

Add to ~/.cursor/mcp.json like this:

{
  "mcpServers": {
    "hyperbrowser": {
      "command": "npx",
      "args": [
        "-y",
        "hyperbrowser-mcp"
      ],
      "env": {
        "HYPERBROWSER_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

Running on Windsurf

Add to your ./codeium/windsurf/model_config.json like this:

{
  "mcpServers": {
    "hyperbrowser": {
      "command": "npx",
      "args": [
        "-y",
        "hyperbrowser-mcp"
      ],
      "env": {
        "HYPERBROWSER_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

Development

For development purposes, you can run the server directly from the source code.

1. Clone the repository:

   git clone [email protected]:hyperbrowserai/mcp.git hyperbrowser-mcp
   cd hyperbrowser-mcp
   

2. Install dependencies:

   npm install # or yarn install
   npm run build
   

3. Run the server:

   node dist/server.js
   

Claude Desktop app

This is an example config for the Hyperbrowser MCP server for the Claude Desktop client.

{
  "mcpServers": {
    "hyperbrowser": {
      "command": "npx",
      "args": [
        "--yes",
        "hyperbrowser-mcp"
      ],
      "env": {
        "HYPERBROWSER_API_KEY": "your-api-key"
      }
    }
  }
}

Tools

• scrape_webpage - Extract formatted (markdown, screenshot etc) content from any webpage
• crawl_webpages - Navigate through multiple linked pages and extract LLM-friendly formatted content
• extract_structured_data - Convert messy HTML into structured JSON
• search_with_bing - Query the web and get results with Bing search
• browser_use_agent - Fast, lightweight browser automation with the Browser Use agent
• openai_computer_use_agent - General-purpose automation using OpenAI’s CUA model
• claude_computer_use_agent - Complex browser tasks using Claude computer use
• create_profile - Creates a new persistent Hyperbrowser profile.
• delete_profile - Deletes an existing persistent Hyperbrowser profile.
• list_profiles - Lists existing persistent Hyperbrowser profiles.

Installing via Smithery

To install Hyperbrowser MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @hyperbrowserai/mcp --client claude

Resources

The server provides the documentation about hyperbrowser through the resources methods. Any client which can do discovery over resources has access to it.

License

This project is licensed under the MIT License.