超浏览器 MCP 服务器

这是超浏览器的模型上下文协议（MCP）服务器。它提供了多种工具，用于抓取网页、提取结构化数据以及爬取页面内容。同时，它还支持轻松接入通用浏览器代理，例如 OpenAI 的 CUA、Anthropic 的 Claude 计算机使用以及浏览器使用功能。

有关超浏览器的更多信息，请参阅 这里。超浏览器 API 支持比 MCP 服务器更丰富的功能集。

关于模型上下文协议的更多信息，请参阅 这里。

目录

• 安装
• 使用
• 工具
• 配置
• 许可证

安装

手动安装

要安装该服务器，请运行以下命令：

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

在 Cursor 上运行

将以下内容添加到 ~/.cursor/mcp.json 文件中：

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

在 Windsurf 上运行

将以下内容添加到你的 ./codeium/windsurf/model_config.json 文件中：

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

开发

出于开发目的，你可以直接从源代码运行服务器。

1. 克隆仓库：

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

2. 安装依赖项：

   npm install # 或 yarn install
   npm run build
   

3. 运行服务器：

   node dist/server.js
   

Claude 桌面应用

以下是为 Claude 桌面客户端配置超浏览器 MCP 服务器的示例。

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

工具

• scrape_webpage - 从任何网页中提取格式化内容（Markdown、截图等）
• crawl_webpages - 遍历多个链接页面并提取适合大语言模型的格式化内容
• extract_structured_data - 将杂乱的 HTML 转换为结构化的 JSON
• search_with_bing - 使用必应搜索查询网络并获取结果
• browser_use_agent - 基于浏览器使用代理的快速轻量级浏览器自动化
• openai_computer_use_agent - 使用 OpenAI 的 CUA 模型进行通用自动化
• claude_computer_use_agent - 使用 Claude 计算机使用功能执行复杂的浏览器任务
• create_profile - 创建一个新的持久化超浏览器用户档案
• delete_profile - 删除现有的持久化超浏览器用户档案
• list_profiles - 列出现有的持久化超浏览器用户档案

通过 Smithery 安装

要通过 Smithery 自动为 Claude 桌面安装超浏览器 MCP 服务器，可以运行以下命令：

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

资源

该服务器通过 resources 方法提供关于超浏览器的文档。任何能够发现资源的客户端都可以访问这些文档。

许可证

本项目采用 MIT 许可证授权。

Hyperbrowser MCP Server 快速上手指南

Hyperbrowser MCP Server 是一个基于模型上下文协议（MCP）的服务端工具，专为 AI 助手设计。它提供了网页抓取、结构化数据提取、全网搜索以及驱动通用浏览器智能体（如 OpenAI CUA、Claude Computer Use）的能力。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux、macOS 或 Windows (需安装 WSL 或 Git Bash)
• Node.js：版本 18 或更高（推荐最新 LTS 版本）
• 包管理器：npm 或 yarn
• API 密钥：您需要拥有一个有效的 Hyperbrowser API Key
• 宿主客户端：已安装支持 MCP 的 AI 编辑器或客户端（如 Cursor, Windsurf, Claude Desktop 等）

安装步骤

1. 获取 API 密钥

请访问 Hyperbrowser 官网注册并获取您的 HYPERBROWSER_API_KEY。

2. 配置 MCP 客户端

根据您的使用场景，选择以下一种方式进行配置。配置的核心是将服务器命令和 API 密钥添加到客户端的配置文件中。

方案 A：Cursor 编辑器

打开或创建 ~/.cursor/mcp.json 文件，添加以下内容：

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

请将 YOUR-API-KEY 替换为您实际的密钥。

方案 B：Windsurf 编辑器

打开或创建 ./codeium/windsurf/model_config.json 文件，添加以下内容：

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

方案 C：Claude Desktop 客户端

找到 Claude Desktop 的配置文件（通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json 或 %APPDATA%\Claude\claude_desktop_config.json），添加：

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

方案 D：通过 Smithery 自动安装 (仅限 Claude Desktop)

如果您希望通过 Smithery 一键安装，可运行以下命令：

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

3. 验证安装

重启您的 AI 编辑器或客户端。在聊天界面中，检查是否已加载 hyperbrowser 工具列表（如 scrape_webpage, search_with_bing 等）。

基本使用

配置完成后，您可以直接在对话中自然语言调用以下功能，无需编写额外代码：

1. 网页内容抓取

让 AI 提取任意网页的内容（支持 Markdown 格式或截图）：

“请使用 scrape_webpage 工具帮我提取 https://example.com 的主要内容，并总结成要点。”

2. 结构化数据提取

将杂乱的 HTML 页面转换为干净的 JSON 数据：

“访问这个电商产品页，使用 extract_structured_data 提取产品名称、价格和库存状态，输出为 JSON 格式。”

3. 联网搜索

利用 Bing 搜索最新信息：

“使用 search_with_bing 查找关于 '2024 年 AI 代理最新进展' 的前五条新闻。”

4. 浏览器自动化代理

执行复杂的浏览器交互任务（如登录、点击、表单填写）：

“使用 browser_use_agent 打开 Google 首页，搜索 'MCP protocol' 并点击第一个结果。” “使用 claude_computer_use_agent 帮我在网站上完成注册流程。”

5. 管理浏览器配置文件

创建或删除持久化的浏览器环境：

“创建一个名为 'test_profile' 的新配置文件。” “列出所有现有的配置文件。”

---

注：更多高级功能及 API 细节请参考 Hyperbrowser 官方文档。