mcp
by: hyperbrowserai
A MCP server implementation for hyperbrowser
📌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.
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
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.