使用说明
浏览MCP服务器
已归档
此存储库已存档,不再维护。
它最初是作为参考实现发布的,并保留用于历史目的。它不应被解释为Browserbase当前生产服务或实现的代表。
模型上下文协议(MCP) 是一种开放协议,可实现LLM应用程序与外部数据源和工具之间的无缝集成。无论您是在构建基于AI的IDE、增强聊天界面,还是创建自定义AI工作流程,MCP都提供了一种标准化的方式将LLM与所需的上下文连接起来。
此服务器提供云浏览器自动化功能,使用 浏览 和 舞台工作人员它使LLM能够与网页交互、提取信息并执行自动化操作。
这是一个自托管版本的 基于浏览器的MCP服务器 具有相同的工具和功能。 我们建议使用托管版本进行最简单的设置。
工具
此服务器公开了6个与 托管Browserbase MCP服务器:
| 工具 | 描述 | 输入 |
|---|---|---|
start |
创建或重用Browserbase会话 | (无) |
end |
关闭当前Browserbase会话 | (无) |
navigate |
导航到URL | { url: string } |
act |
在页面上执行操作 | { action: string } |
observe |
观察页面上可操作的元素 | { instruction: string } |
extract |
从页面中提取数据 | { instruction?: string } |
如何设置
我们目前支持MCP服务器的两种传输方式,STDIO和SHTTP。我们建议您将SHTTP与我们的托管MCP服务器一起使用,以充分利用服务器的全部容量。
SHTTP(托管MCP):
使用Browserbase托管的MCP服务器 https://mcp.browserbase.com/mcp。这是最简单的入门方法——我们托管服务器,并为Gemini提供LLM成本 最佳性能模型 在 舞台工作人员.
有关完整的设置说明,请参阅 基于浏览器的MCP文档.
如果您的客户支持SHTTP:
{
"mcpServers": {
"browserbase": {
"type": "http",
"url": "https://mcp.browserbase.com/mcp"
}
}
}
如果您的客户不支持SHTTP:
{
"mcpServers": {
"browserbase": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.browserbase.com/mcp"]
}
}
}
STDIO(自托管):
您可以使用我们在NPM上托管的服务器,也可以通过克隆此仓库在本地完全运行它。
注: 如果你想使用不同的模型,你必须将--modelName添加到参数中,并将相应的键作为参数提供。更多信息如下。
通过NPM运行(推荐)
进入MCP配置JSON并添加浏览器基础服务器:
{
"mcpServers": {
"browserbase": {
"command": "npx",
"args": ["@browserbasehq/mcp"],
"env": {
"BROWSERBASE_API_KEY": "",
"BROWSERBASE_PROJECT_ID": "",
"GEMINI_API_KEY": ""
}
}
}
}
就是这样!重新加载您的MCP客户端,您就可以开始了。
要运行100%本地:
选项1:直接安装
git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
npm install && npm run build
选项2:Docker
git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
docker build -t mcp-browserbase .
然后在MCP配置JSON中运行服务器:
使用直接安装
{
"mcpServers": {
"browserbase": {
"command": "node",
"args": ["/path/to/mcp-server-browserbase/cli.js"],
"env": {
"BROWSERBASE_API_KEY": "",
"BROWSERBASE_PROJECT_ID": "",
"GEMINI_API_KEY": ""
}
}
}
}
使用Docker
{
"mcpServers": {
"browserbase": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"BROWSERBASE_API_KEY",
"-e",
"BROWSERBASE_PROJECT_ID",
"-e",
"GEMINI_API_KEY",
"mcp-browserbase"
],
"env": {
"BROWSERBASE_API_KEY": "",
"BROWSERBASE_PROJECT_ID": "",
"GEMINI_API_KEY": ""
}
}
}
}
配置
Browsebase MCP服务器接受以下命令行标志:
| 标志 | 描述 |
|---|---|
--proxies |
为会话启用浏览器基础代理 |
--verified |
启用浏览器基础验证身份(仅适用于Scale Plan用户) |
--advancedStealth |
已弃用的别名 --verified |
--keepAlive |
启用浏览器保持活动会话 |
--contextId <contextId> |
指定要使用的浏览器基础上下文ID |
--persist |
是否持久化Browserbase上下文(默认值:true) |
--port <port> |
用于侦听HTTP/SHTTP传输的端口 |
--host <host> |
将服务器绑定到的主机(默认值:localhost,所有接口使用0.0.0.0) |
--browserWidth <width> |
浏览器视口宽度(默认值:1024) |
--browserHeight <height> |
浏览器视口高度(默认值:768) |
--modelName <model> |
Stagehand使用的模型(默认:google/gemini-2.5-flash-lite) |
--modelApiKey <key> |
自定义模型提供程序的API密钥(使用自定义模型时需要) |
--experimental |
启用实验功能(默认值:false) |
这些标志可以直接传递给CLI,也可以在MCP配置文件中配置。
注: 这些标志只能用于自托管服务器(npx@browserbasehq/mcp或Docker)。
模型配置
Stagehand默认使用谷歌的Gemini 2.5 Flash Lite模型,但您可以将其配置为使用GPT-4o、Claude或其他提供商等其他模型。
重要:使用任何自定义模型(非默认)时,必须使用 --modelApiKey 旗帜。
{
"mcpServers": {
"browserbase": {
"command": "npx",
"args": [
"@browserbasehq/mcp",
"--modelName",
"anthropic/claude-sonnet-4.5",
"--modelApiKey",
"your-anthropic-api-key"
],
"env": {
"BROWSERBASE_API_KEY": "",
"BROWSERBASE_PROJECT_ID": ""
}
}
}
}
注意:Stagehand必须支持该模型。查看文档 这里.
链接
许可证
根据Apache 2.0许可证授权。
版权所有2025 Browserbase,股份有限公司。