# mcp

> MCP Server

The Hyperbrowser MCP Server provides tools for web scraping, data extraction, and crawling, offering access to browser agents like OpenAI's CUA and Anthropic's Claude Computer Use. It supports the Model Context Protocol.

## Overview

- **Category:** AI
- **Language:** TypeScript
- **Stars:** 786
- **Forks:** 6
- **Owner:** hyperbrowserai
- **GitHub:** https://github.com/hyperbrowserai/mcp
- **Created:** 2025-02-25T19:06:01+00:00
- **Updated:** 2025-03-28T23:59:36+00:00
- **Source:** https://model-context-protocol.com/servers/hyperbrowser-mcp-server-web-scraping

## Setup

## Setup

### Manual Installation
To install the server, run:

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

## Running on Cursor
Add to `~/.cursor/mcp.json` like this:
```json
{
  "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:
```json
{
  "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:

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

2. Install dependencies:

   ```sh
   npm install # or yarn install
   npm run build
   ```

3. Run the server:

   ```sh
   node dist/server.js
   ```

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

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


### Installing via Smithery

To install Hyperbrowser MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@hyperbrowserai/mcp):

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

## Tools

## Available Tools

1.  `scrape_webpage` - Extract formatted (markdown, screenshot etc) content from any webpage
2.  `crawl_webpages` - Navigate through multiple linked pages and extract LLM-friendly formatted content
3.  `extract_structured_data` - Convert messy HTML into structured JSON
4.  `search_with_bing` - Query the web and get results with Bing search
5.  `browser_use_agent` - Fast, lightweight browser automation with the Browser Use agent
6.  `openai_computer_use_agent` - General-purpose automation using OpenAI’s CUA model
7.  `claude_computer_use_agent` - Complex browser tasks using Claude computer use