Servidor Mcp de Hyperbrowser
Una implementación de servidor MCP para hyperbrowser
Resumen
¿Qué es MCP?
MCP, o Protocolo Multi-Canal, es una implementación de servidor diseñada para el marco de trabajo Hyperbrowser. Facilita la comunicación entre varios componentes del ecosistema Hyperbrowser, permitiendo un intercambio de datos y una interacción sin problemas a través de diferentes canales. Esta implementación es particularmente útil para desarrolladores que buscan construir aplicaciones que requieren capacidades robustas de comunicación multi-canal.
Características de MCP
- Soporte Multi-Canal: MCP permite la comunicación simultánea a través de múltiples canales, mejorando la eficiencia de la transferencia de datos y la interacción.
- Código Abierto: Al ser un repositorio público, MCP está abierto a contribuciones y modificaciones, permitiendo a los desarrolladores personalizarlo según sus necesidades.
- Fácil Integración: El servidor se puede integrar fácilmente en aplicaciones Hyperbrowser existentes, lo que lo convierte en una opción versátil para los desarrolladores.
- Comunidad Activa: Con un número creciente de estrellas y bifurcaciones, MCP se beneficia de una comunidad activa que contribuye a su desarrollo y mejora continua.
Cómo Usar MCP
-
Clona el Repositorio: Comienza clonando el repositorio de MCP desde GitHub usando el comando:
git clone https://github.com/hyperbrowserai/mcp.git
-
Instala Dependencias: Navega al directorio clonado e instala las dependencias necesarias. Esto se puede hacer típicamente usando un gestor de paquetes como npm o yarn.
-
Ejecuta el Servidor: Inicia el servidor MCP ejecutando el comando apropiado en tu terminal. Esto iniciará el servidor y lo preparará para manejar solicitudes.
-
Integra con Tu Aplicación: Utiliza los puntos finales de API proporcionados para integrar MCP en tu aplicación Hyperbrowser, permitiendo la comunicación multi-canal.
-
Contribuye: Si tienes mejoras o características que agregar, siéntete libre de bifurcar el repositorio, hacer tus cambios y enviar una solicitud de extracción para contribuir al proyecto MCP.
Preguntas Frecuentes
¿Qué lenguajes de programación se utilizan en MCP?
MCP está construido principalmente con JavaScript y Node.js, lo que lo hace accesible para desarrolladores familiarizados con estas tecnologías.
¿Es MCP adecuado para uso en producción?
Sí, MCP está diseñado para ser robusto y escalable, lo que lo hace adecuado para entornos de producción. Sin embargo, siempre se recomienda probar a fondo antes de la implementación.
¿Cómo puedo reportar problemas o solicitar características?
Puedes reportar problemas o solicitar características abriendo un problema en el repositorio de GitHub de MCP. La comunidad y los mantenedores monitorean y responden activamente a los comentarios.
¿Puedo contribuir al proyecto MCP?
¡Absolutamente! Las contribuciones son bienvenidas. Puedes bifurcar el repositorio, hacer tus cambios y enviar una solicitud de extracción para revisión.
¿Dónde puedo encontrar la documentación de MCP?
La documentación de MCP se puede encontrar típicamente dentro del propio repositorio, a menudo en un archivo README.md
o en un directorio dedicado docs
.
Detalle
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
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.
-
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
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 webpagecrawl_webpages
- Navigate through multiple linked pages and extract LLM-friendly formatted contentextract_structured_data
- Convert messy HTML into structured JSONsearch_with_bing
- Query the web and get results with Bing searchbrowser_use_agent
- Fast, lightweight browser automation with the Browser Use agentopenai_computer_use_agent
- General-purpose automation using OpenAI’s CUA modelclaude_computer_use_agent
- Complex browser tasks using Claude computer usecreate_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.
Configuración del Servidor
{
"mcpServers": {
"mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--hyperbrowserai--mcp--mcp",
"npm run start"
],
"env": {
"HYPERBROWSER_API_KEY": "hyperbrowser-api-key"
}
}
}
}