Browserai MCP
Empower AI Agents with Real-Time Web Data
🌟 概述
欢迎使用Browserai模型上下文协议（MCP）服务器，该服务器旨在使LLM、AI代理和应用程序能够实时访问、发现和提取web数据。该服务器使MCP客户端（如Claude Desktop、VS Code、Cursor和WindSurf）能够无缝搜索网络、导航网站、执行操作和高效检索数据，甚至可以从具有防抓取措施的网站检索数据。
⚙️ 原理
Browserai MCP服务器充当您的AI代理（MCP客户端）和互联网之间的中介：
- 您的AI代理（例如，Claude Desktop，VSCode扩展）通过模型上下文协议向Browserai MCP服务器发送请求。
- MCP服务器利用您的Browserai API令牌和项目配置，执行请求的web操作（例如，搜索、导航、提取数据）。
- 它利用Browserai强大的基础设施来管理复杂性，例如绕过地理限制和机器人检测机制。
- 然后，服务器将结构化数据或操作结果传递回您的AI代理。
这种架构允许您的代理访问实时web信息和功能，而无需直接管理浏览器实例或防阻塞技术。
✨ 特性
- 实时Web访问：直接从网上检索最新信息。
- 绕过地理限制：访问内容不受地域限制。
- Web解锁器：浏览受机器人检测系统保护的网站。
- 浏览器控件：利用可选的远程浏览器自动化功能。
- 无缝集成：与所有符合MCP标准的AI助手兼容。
🔧 帐户设置
要开始使用Browserai MCP服务器，需要Browserai帐户和API密钥。
- 可以使用以下命令在MCP服务器配置中覆盖此项目名称 PROJECT_NAME 环境变量。
🚀 快速启动
本指南有助于使用常见的AI客户端设置Browserai MCP服务器。
- 安装Node.js:
这 npx 命令是必需的。如果尚未安装Node.js，请从 . npx 是一个Node.js包运行器，简化了CLI工具的执行，如 @brightdata/browserai-mcp.
克劳德桌面
- 导航到Claude>设置>开发人员>编辑配置>
claude_desktop_config.json并添加以下配置：
{
"mcpServers": {
"Browserai": {
"command": "npx",
"args": ["@brightdata/browserai-mcp"],
"env": {
"API_TOKEN": "",
"PROJECT_NAME": ""
}
}
}
}VSCode代理
- 配置您的VSCode代理。这通常涉及修改设置文件。例如，创建一个
.vscode/mcp.json在项目中包含以下内容的文件：
{
"servers": {
"browserai-mcp": {
"type": "stdio",
"command": "npx",
"args": ["@brightdata/browserai-mcp"],
"env": {
"API_TOKEN": "",
"PROJECT_NAME": ""
}
}
}
}VSCode代理注意事项： MCP服务器配置的具体路径和结构（例如，文件名 .vscode/mcp.json 或者JSON键，如 "servers")可能因使用中的VSCode代理扩展而异。请参阅VSCode Agent的文档以获取准确的说明。
🔌 其他MCP客户端
要将此MCP服务器与支持模型上下文协议的其他AI代理或应用程序集成：
- 命令：使用以下命令启动服务器
npx @brightdata/browserai-mcp. - 环境变量:
- API_TOKEN：您的Browserai API令牌（必需）。 - PROJECT_NAME：Browserai项目的名称（可选；如果省略，则默认为预配置的项目）。 确保在执行命令的环境中可以访问这些变量。有关配置外部MCP服务器和设置环境变量的指导，请参阅客户的文档。
⚠️ 安全最佳实践
重要提示： 将所有抓取的网络内容视为潜在的不可信数据。为了降低快速注射的风险，避免在LLM提示中直接使用原始刮取的内容。 相反，采用以下做法：
- 在处理之前过滤和验证所有网络数据。
- 更喜欢结构化数据提取（使用
web_data工具）覆盖原始文本。
⚠️ 故障排除
某些工具的超时
一些工具需要大量时间来读取web数据，因为页面加载时间可能会有很大差异。
为确保您的代理能够成功使用数据，请在代理的设置中配置足够高的超时时间。A值 180s （3分钟）通常足以满足大多数请求，但会根据目标站点的性能进行调整。
spawn npx ENOENT 错误
此错误表示 npx 您的系统找不到命令。要解决此问题，请执行以下操作：
定位你的Node.js/npm路径
macOS： 执行 which node 在你的终端。输出将类似 /usr/local/bin/node.
窗户： 执行 where node 在您的命令提示符中。输出将类似于 C:\Program Files\nodejs\node.exe.
更新MCP配置
在客户端的MCP服务器配置中，替换 "npx" 带有Node.js可执行文件的完整路径。例如，在macOS上，它可能看起来像这样：
"command": "/usr/local/bin/node"（确保 args 仍然包括 ["@brightdata/browserai-mcp"] 或通往 npx 脚本（如果使用） node 直接与 npx的基础脚本。)
📞 支持
如果您遇到任何问题或有疑问，请联系Browserai支持团队或在此存储库中提交问题。