概览欢迎使用 Browserai 模型上下文协议Model Context ProtocolMCP服务器。它旨在让大语言模型LLMs、AI 代理和应用能够实时访问、发现并提取网页数据。该服务器使 MCP 客户端如 Claude Desktop、VS Code、Cursor、WindSurf 等能够无缝搜索全网、导航网站、执行操作并高效获取数据即使面对带有反爬机制的网站也能应对自如。⚙️ 工作原理Browserai MCP 服务器作为你的 AI 代理MCP 客户端与互联网之间的中间层运作你的 AI 代理例如 Claude Desktop、某个 VSCode 扩展通过 MCP 向 Browserai MCP 服务器发送请求。MCP 服务器使用你的 Browserai API 令牌和项目配置执行所请求的网页操作如搜索、导航、抽取数据。它依托 Browserai 的强大基础设施来处理复杂问题例如绕过地理限制与机器人检测机制。服务器将结构化数据或操作结果返回给你的 AI 代理。这种架构让你的代理在无需直接管理浏览器实例或反封锁技术的情况下获取实时的网页信息与能力。✨ 功能特性实时网页访问直接从网络检索最新信息轻松绕过地理限制不受地域访问限制Web Unlocker应对网站的机器人检测与防爬策略浏览器控制可选的远程浏览器自动化能力无缝集成兼容所有符合 MCP 的 AI 助手 账户设置开始使用 Browserai MCP 服务器前你需要 Browserai 账户与 API 密钥。确保你已在 browser.ai 注册账号。新用户可获得免费额度进行测试并支持按量计费。在用户面板获取你的 API 密钥。在控制台创建一个新项目。该项目名称可在 MCP 服务器配置中通过PROJECT_NAME环境变量覆盖。 快速开始以下指南帮助你将 Browserai MCP 服务器接入常见 AI 客户端。安装 Node.js需要使用npx命令。如果你的系统尚未安装 Node.js请从Node.js 官网下载并安装。npx是一个 Node.js 包运行器可简化运行诸如brightdata/browserai-mcp这类 CLI 工具。Claude Desktop前往 Claude Settings Developer Edit Config claude_desktop_config.json添加如下配置{mcpServers:{Browserai:{command:npx,args:[brightdata/browserai-mcp],env:{API_TOKEN:your-browserai-api-token,PROJECT_NAME:your-browserai-project-name (optional)}}}}VSCode Agent配置你的 VSCode Agent。通常需要修改一个设置文件。例如在项目中创建.vscode/mcp.json并写入以下内容{servers:{browserai-mcp:{type:stdio,command:npx,args:[brightdata/browserai-mcp],env:{API_TOKEN:your-browserai-api-token,PROJECT_NAME:your-browserai-project-name (optional)}}}}注意VSCode AgentMCP 服务器配置的具体路径与结构如文件名.vscode/mcp.json或 JSON 的servers键可能因所用的 VSCode Agent 扩展而异。请参考你的 VSCode Agent 插件文档获取准确说明。 其他 MCP 客户端将该 MCP 服务器集成到其他支持 MCP 的 AI 代理或应用中命令使用npx brightdata/browserai-mcp启动服务器。环境变量API_TOKEN你的 Browserai API 令牌必填PROJECT_NAME你的 Browserai 项目名可选若省略则使用预配置项目确保这些变量在执行命令的环境中可用。请参考你的客户端文档了解如何配置外部 MCP 服务器与设置环境变量。⚠️ 安全最佳实践重要提示将所有抓取到的网页内容视为潜在不可信数据。为降低提示注入Prompt Injection风险请避免将原始网页内容直接用于 LLM 提示中。建议采用以下做法在处理前对网页数据进行筛选与校验优先使用结构化数据抽取通过web_data工具而非原始文本⚠️ 故障排查某些工具出现超时部分工具在读取网页数据时可能耗时较长因为页面加载时间差异较大。请在代理/客户端设置中配置足够大的超时时间以确保可以成功消费数据。一般建议设置为180s3 分钟但你应根据目标站点的实际表现进行调整。spawn npx ENOENT错误该错误说明系统找不到npx命令。可通过以下方式解决查找你的 Node.js/npm 路径macOS在终端执行which node。输出类似于/usr/local/bin/node。Windows在命令提示符执行where node。输出类似于C:\Program Files\nodejs\node.exe。更新你的 MCP 配置在客户端的 MCP 服务器配置中用 Node.js 的完整路径替换npx。例如在 macOS 上可能是command:/usr/local/bin/node确保args仍包含[brightdata/browserai-mcp]或在使用node直接运行npx底层脚本时提供相应的脚本路径。 支持如果你遇到问题或有任何疑问请联系 Browserai 支持团队或在本仓库提交 issue。