关于 Hyperbrowser MCP Server
Hyperbrowser MCP Server 是 Hyperbrowser 提供的 MCP 服务,提供网页抓取、结构化数据提取和网站爬取工具。它还可以调用通用浏览器 Agent,适合需要从网页获取内容的开发者和 AI 应用。
主要功能
- 01抓取网页并输出 markdown、截图等格式
- 02爬取多个链接页面并输出 LLM 友好的内容
- 03将杂乱的 HTML 转换为结构化 JSON
- 04通过 Bing 搜索获取网页结果
- 05提供 Browser Use、OpenAI CUA 和 Claude 电脑操作等浏览器 Agent 工具
- 06管理可持久保存的 Hyperbrowser 配置档
适用场景
- 01将网页内容提取为 Agent 可读的文本
- 02从多个相关页面批量采集数据
- 03把网页中的信息整理为 JSON 结构
MCP 相关
该项目是 MCP 服务,向 MCP 客户端暴露抓取、爬取、搜索和浏览器 Agent 等工具,并通过 resources 提供 Hyperbrowser 文档。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
10收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | string | 是 | 要抓取的网页 URL |
| sessionOptions | object | 否 | 浏览器会话的选项。未明确提及时,请勿设置这些选项 |
| sessionOptions.useProxy | boolean | 否 | 是否使用代理。建议设为 false。 |
| sessionOptions.useStealth | boolean | 否 | 是否使用隐身模式。建议设为 false。 |
| sessionOptions.solveCaptchas | boolean | 否 | 是否解决验证码。建议设为 false。 |
| sessionOptions.acceptCookies | boolean | 否 | 是否自动关闭接受 Cookie 弹窗。建议设为 false。 |
| sessionOptions.profile | object | 否 | 使用持久化 Hyperbrowser 配置文件的选项 |
| sessionOptions.profile.id | string | 否 | 会话要使用的持久化配置文件 ID |
| sessionOptions.profile.persistChanges | boolean | 否 | 是否将会话期间所做的更改保存到配置文件。建议设为 true。 |
| outputFormat | array | 是 | 输出格式 |
详细介绍
Hyperbrowser MCP 服务
这是 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"
}
}
}
}
开发
如需开发,可以直接从源代码运行服务。
-
克隆代码仓库:
git clone [email protected]:hyperbrowserai/mcp.git hyperbrowser-mcp cd hyperbrowser-mcp -
安装依赖项:
npm install # or yarn install npm run build -
运行服务:
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 转换为结构化 JSONsearch_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 许可证。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。