浏览器ai-mcp
项目介绍
🌟 概述
欢迎来到Browserai模型上下文协议（MCP）服务器，该服务器旨在使大型语言模型（LLMs）、AI代理和应用程序能够实时访问、发现和提取网络数据。此服务器使MCP客户端（如Claude Desktop、VS Code、Cursor和WindSurf）能够无缝地搜索网络、导航网站、执行操作并高效地检索数据，即使是从具有反爬虫措施的网站也是如此。
⚙️ 工作原理
Browserai MCP服务器作为您的AI代理（MCP客户端）与互联网之间的中介：
- 您的AI代理（例如，Claude Desktop、VSCode扩展）通过模型上下文协议向Browserai MCP服务器发送请求。
- MCP服务器利用您的Browserai API令牌和项目配置执行请求的网络操作（例如，搜索、导航、提取数据）。
- 它利用Browserai的强大基础设施来管理复杂性，如绕过地理限制和机器人检测机制。
- 然后，服务器将结构化数据或操作结果返回给您的AI代理。
这种架构允许您的代理访问实时网络信息和功能，而无需直接管理浏览器实例或反阻止技术。
✨ 特性
- 实时网络访问：直接从网络获取最新信息。
- 绕过地理限制：无地理限制地访问内容。
- 网页解锁器：导航受机器人检测系统保护的网站。
- 浏览器控制：利用可选的远程浏览器自动化功能。
- 无缝集成：兼容所有符合MCP标准的AI助手。
🔧 账户设置
要开始使用Browserai MCP服务器，需要一个Browserai账户和API密钥。
- 确保您在browser.ai上拥有一个账户。新用户可以获得免费测试信用额度，并提供按需付费选项。
- 从user dashboard获取您的API密钥。
- 在您的仪表板中创建一个新的项目。
- 此项目名称可以在您的MCP服务器配置中使用
PROJECT_NAME环境变量进行覆盖。
- 此项目名称可以在您的MCP服务器配置中使用
🚀 快速入门
本指南帮助您设置Browserai MCP服务器与常见的AI客户端。
- 安装Node.js：
需要
npx命令。如果尚未安装Node.js，请从node.js官网下载并安装。npx是一个Node.js包运行器，简化了像@brightdata/browserai-mcp这样的CLI工具的执行。
Claude Desktop
- 导航到Claude > 设置 > 开发者 > 编辑配置 >
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 (可选)>"
}
}
}
}
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 (可选)>"
}
}
}
}
注意对于VSCode Agent：MCP服务器配置的具体路径和结构（例如，文件名.vscode/mcp.json或JSON键如servers）可能会根据使用的VSCode Agent扩展有所不同。请参阅您的VSCode Agent文档以获取精确的说明。
🔌 其他MCP客户端
要将此MCP服务器与其他支持模型上下文协议的AI代理或应用程序集成：
- 命令：使用命令
npx @brightdata/browserai-mcp启动服务器。 - 环境变量：
API_TOKEN：您的Browserai API令牌（必需）。PROJECT_NAME：您的Browserai项目的名称（可选；如果省略，默认为预配置的项目）。 确保这些变量在执行命令的环境中可用。请参考您的客户端文档以获取有关配置外部MCP服务器和设置环境变量的指导。
⚠️ 安全最佳实践
重要：将所有抓取的网络内容视为潜在的不可信数据。为了减轻提示注入风险，避免直接在LLM提示中使用原始抓取的内容。 相反，采用以下做法：
- 在处理之前过滤和验证所有网络数据。
- 优先使用结构化数据提取（使用
web_data工具）而不是原始文本。
⚠️ 故障排除
使用某些工具时超时
一些工具需要大量时间来读取网络数据，因为页面加载时间可能差异很大。
为了确保您的代理可以成功消费数据，请在代理的设置中配置足够高的超时值。一般而言，180s（3分钟）对于大多数请求来说是足够的，但应根据目标站点的性能进行调整。
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服务器配置中，将"npx"替换为您Node.js可执行文件的完整路径。例如，在macOS中，它可能看起来像这样：
"command": "/usr/local/bin/node"
（确保args仍然包括["@brightdata/browserai-mcp"]或直接使用node时npx底层脚本的路径。）
📞 支持
如果您遇到任何问题或有任何疑问，请联系Browserai支持团队或在此仓库提交问题。