📌Overview

Purpose: The Hyperbrowser MCP Server is designed to facilitate the scraping, extraction, and structuring of data from webpages while providing access to various browser agents.

Overview: This server implements the Model Context Protocol (MCP) to offer tools that enable users to efficiently navigate and interact with web content. Via simple commands, users can harness the power of automation and data extraction in a user-friendly manner.

Key Features:

Webpage Scraping: Extracts formatted content from any webpage, including markdown and screenshots, making data retrieval straightforward.
Web Crawling: Navigates through linked pages to gather LLM-friendly formatted content, enhancing the depth of data collection.
Structured Data Extraction: Converts unorganized HTML into structured JSON, improving the usability of the retrieved data.
Bing Search Integration: Allows querying of the web and retrieves results, expanding the server's functionality beyond local data.
Automation Agents: Supports various browser automation scenarios using agents like OpenAI's CUA and Claude's Computer Use, providing flexibility for complex tasks.

Hyperbrowser MCP Server

This is Hyperbrowser's Model Context Protocol (MCP) Server. It provides tools to scrape, extract structured data, and crawl webpages. It also offers 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.

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 as follows:

{
  "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 as follows:

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

Development

To run the server from source for development:

Clone the repository:

git clone git@github.com:hyperbrowserai/mcp.git hyperbrowser-mcp
cd hyperbrowser-mcp

Install dependencies:

npm install # or yarn install
npm run build

Run the server:
```
node dist/server.js
```

Claude Desktop App Configuration

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 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.

mcp