Hyperbrowser Mcp Server

What is MCP?

MCP, or Multi-Channel Protocol, is a server implementation designed for the Hyperbrowser framework. It facilitates communication between various components of the Hyperbrowser ecosystem, enabling seamless data exchange and interaction across different channels. This implementation is particularly useful for developers looking to build applications that require robust multi-channel communication capabilities.

Features of MCP

• Multi-Channel Support: MCP allows for simultaneous communication across multiple channels, enhancing the efficiency of data transfer and interaction.
• Open Source: Being a public repository, MCP is open for contributions and modifications, allowing developers to customize it according to their needs.
• Easy Integration: The server can be easily integrated into existing Hyperbrowser applications, making it a versatile choice for developers.
• Active Community: With a growing number of stars and forks, MCP benefits from an active community that contributes to its ongoing development and improvement.

How to Use MCP

1. Clone the Repository: Start by cloning the MCP repository from GitHub using the command:

   git clone https://github.com/hyperbrowserai/mcp.git
   

2. Install Dependencies: Navigate to the cloned directory and install the necessary dependencies. This can typically be done using a package manager like npm or yarn.

3. Run the Server: Launch the MCP server by executing the appropriate command in your terminal. This will start the server and make it ready to handle requests.

4. Integrate with Your Application: Use the provided API endpoints to integrate MCP into your Hyperbrowser application, allowing for multi-channel communication.

5. Contribute: If you have improvements or features to add, feel free to fork the repository, make your changes, and submit a pull request to contribute to the MCP project.

Frequently Asked Questions

What programming languages are used in MCP?

MCP is primarily built using JavaScript and Node.js, making it accessible for developers familiar with these technologies.

Is MCP suitable for production use?

Yes, MCP is designed to be robust and scalable, making it suitable for production environments. However, it's always recommended to test thoroughly before deployment.

How can I report issues or request features?

You can report issues or request features by opening an issue on the MCP GitHub repository. The community and maintainers actively monitor and respond to feedback.

Can I contribute to the MCP project?

Absolutely! Contributions are welcome. You can fork the repository, make your changes, and submit a pull request for review.

Where can I find the documentation for MCP?

Documentation for MCP can typically be found within the repository itself, often in a README.md file or a dedicated docs directory.

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 git@github.com: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.