mcpField
H
Hyperbrowser MCP Server

Hyperbrowser MCP Server

本地服务
github.com/hyperbrowserai浏览器自动化79275 周前更新

关于 Hyperbrowser MCP Server

Hyperbrowser MCP Server 是 Hyperbrowser 提供的 MCP 服务,提供网页抓取、结构化数据提取和网站爬取工具。它还可以调用通用浏览器 Agent,适合需要从网页获取内容的开发者和 AI 应用。

主要功能

  1. 01抓取网页并输出 markdown、截图等格式
  2. 02爬取多个链接页面并输出 LLM 友好的内容
  3. 03将杂乱的 HTML 转换为结构化 JSON
  4. 04通过 Bing 搜索获取网页结果
  5. 05提供 Browser Use、OpenAI CUA 和 Claude 电脑操作等浏览器 Agent 工具
  6. 06管理可持久保存的 Hyperbrowser 配置档

适用场景

  1. 01将网页内容提取为 Agent 可读的文本
  2. 02从多个相关页面批量采集数据
  3. 03把网页中的信息整理为 JSON 结构

MCP 相关

该项目是 MCP 服务,向 MCP 客户端暴露抓取、爬取、搜索和浏览器 Agent 等工具,并通过 resources 提供 Hyperbrowser 文档。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"hyperbrowserai": {
"command": "npx",
"args": [
"-y",
"hyperbrowser-mcp"
],
"env": {
"HYPERBROWSER_API_KEY": "<HYPERBROWSER_API_KEY>"
}
}
}
}
启动命令npx -y hyperbrowser-mcp
需要配置的环境变量
HYPERBROWSER_API_KEY密钥

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmhyperbrowser-mcp

工具

10

收录的工具列表 · 更新于 3 周前

参数类型必填说明
urlstring是要抓取的网页 URL
sessionOptionsobject否浏览器会话的选项。未明确提及时,请勿设置这些选项
sessionOptions.useProxyboolean否是否使用代理。建议设为 false。
sessionOptions.useStealthboolean否是否使用隐身模式。建议设为 false。
sessionOptions.solveCaptchasboolean否是否解决验证码。建议设为 false。
sessionOptions.acceptCookiesboolean否是否自动关闭接受 Cookie 弹窗。建议设为 false。
sessionOptions.profileobject否使用持久化 Hyperbrowser 配置文件的选项
sessionOptions.profile.idstring否会话要使用的持久化配置文件 ID
sessionOptions.profile.persistChangesboolean否是否将会话期间所做的更改保存到配置文件。建议设为 true。
outputFormatarray是输出格式

详细介绍

Hyperbrowser MCP 服务

smithery badge

Frame 5

这是 Hyperbrowser 的模型上下文协议(MCP)服务。它提供多种工具,用于抓取网页、提取结构化数据和爬取网页。它还可以轻松使用通用浏览器 Agent,例如 OpenAI 的 CUA、Anthropic 的 Claude Computer Use 和 Browser Use。

有关 Hyperbrowser 的更多信息,请点击此处。Hyperbrowser 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 [email protected]:hyperbrowserai/mcp.git hyperbrowser-mcp
    cd hyperbrowser-mcp
    
  2. 安装依赖项:

    npm install # or yarn install
    npm run build
    
  3. 运行服务:

    node dist/server.js
    

Claude 桌面应用

这是 Hyperbrowser MCP 服务在 Claude 桌面客户端中的示例配置。

{
  "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 - 使用 Bing 搜索查询网络并获取结果
  • browser_use_agent - 使用 Browser Use Agent 进行快速、轻量的浏览器自动化
  • openai_computer_use_agent - 使用 OpenAI 的 CUA 模型执行通用自动化操作
  • claude_computer_use_agent - 使用 Claude computer use 执行复杂的浏览器任务
  • create_profile - 创建新的持久化 Hyperbrowser 配置文件。
  • delete_profile - 删除现有的持久化 Hyperbrowser 配置文件。
  • list_profiles - 列出现有的持久化 Hyperbrowser 配置文件。
通过 Smithery 安装

如需通过 Smithery 自动为 Claude 桌面应用安装 Hyperbrowser MCP 服务:

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

资源

服务通过 resources 方法提供 Hyperbrowser 文档。任何支持发现资源的客户端都可以访问这些文档。

许可证

本项目采用 MIT 许可证。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。