使用说明
Bright Data MCP
Enhance AI Agents with Real-Time Web Data
🌟 概述
欢迎使用官方的Bright Data Model Context Protocol(MCP)服务器,使LLM、代理和应用程序能够实时访问、发现和提取web数据。此服务器允许MCP客户端(如Claude Desktop、Cursor、Windsurf等)无缝搜索网络、浏览网站、采取行动和检索数据,而不会被阻止,非常适合抓取任务。
✨ 特性
- 实时Web访问:直接从网上获取最新信息
- 绕过地理限制:访问内容不受位置限制
- Web解锁器:使用机器人检测保护浏览网站
- 浏览器控件:可选的远程浏览器自动化功能
- 无缝集成:适用于所有兼容MCP的AI助手
🚀 Claude Desktop快速入门
-
安装
nodejs为了得到npx命令(node.js模块运行器)。安装说明可以在 node.js网站 -
转到Claude>设置>开发人员>编辑配置>Claude_desktop_Config.json,以包含以下内容:
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<insert-your-api-token-here>",
"WEB_UNLOCKER_ZONE": "<optional if you want to override the default mcp_unlocker zone name>",
"BROWSER_AUTH": "<optional if you want to enable remote browser control tools>"
}
}
}
}
🔧 可用工具
⚠️ 安全最佳实践
重要提示: 始终将抓取的网络内容视为不受信任的数据。切勿在LLM提示中直接使用原始刮取内容物,以避免潜在的快速注射风险。 相反:
- 在处理之前过滤和验证所有web数据
- 使用结构化数据提取而不是原始文本(web_data工具)
🔧 帐户设置
-
确保你有一个帐户 brightdata.com (新用户可获得免费测试积分,并提供按需付费选项)
-
从获取API密钥 用户设置页面
-
(可选)创建自定义Web解锁器区域
- 默认情况下,我们使用您的API令牌自动创建Web解锁器区域
- 为了获得更多控制,您可以在您的 控制面板 并用
WEB_UNLOCKER_ZONE环境变量
-
(可选)要启用浏览器控制工具,请执行以下操作:
- 访问Bright Data控制面板 brightdata.com/cp/zzones
- 创建新的“浏览器API”区域
- 创建后,从浏览器API概述选项卡复制身份验证字符串
- 身份验证字符串的格式如下:
brd-customer-[your-customer-ID]-zone-[your-zone-ID]:[your-password]
🔌 其他MCP客户端
要将此MCP服务器与其他代理类型一起使用,您应该使以下内容适应您的特定软件:
- 运行MCP服务器的完整命令是
npx @brightdata/mcp - 环境变量
API_TOKEN=<your-token>运行服务器时必须存在
🎮 尝试Bright Data MCP游乐场
想在不设置任何内容的情况下尝试Bright Data MCP吗?
看看这个游乐场 史密瑟里:
该平台提供了一种无需任何本地设置即可探索Bright Data MCP功能的简单方法。只需登录并开始尝试网络数据收集!
💡 使用示例
此MCP服务器将能够帮助的一些示例查询:
- “在谷歌上搜索一些即将在[你所在地区]上映的电影”
- “特斯拉目前的市值是多少?”
- “今天的维基百科文章是什么?”
- “[你所在地]的7天天气预报是什么?”
- “在三位收入最高的科技公司首席执行官中,他们的职业生涯有多久了?”
🎬 演示
有关YouTube教程和演示: 演示
下面的视频演示了Claude Desktop的一个最小用例:
⚠️ 故障排除
使用某些工具时超时
一些工具可能涉及读取网络数据,在极端情况下加载页面所需的时间可能会有很大差异。
为确保您的代理能够使用数据,请在代理设置中设置足够高的超时时间。
A值 180s 应该足以满足99%的请求,但有些网站的加载速度比其他网站慢,因此请根据您的需求进行调整。
生成npx ENOONT
当您的系统找不到 npx 命令。要修复它:
查找npm/节点路径
macOS:
which node
显示路径如下 /usr/local/bin/node
窗户:
where node
显示路径如下 C:\Program Files\nodejs\node.exe
更新您的MCP配置:
更换 npx 使用Node的完整路径的命令,例如,在mac上,它将如下所示:
"command": "/usr/local/bin/node"
👨💻 贡献
我们欢迎为改进Bright Data MCP做出贡献!以下是您可以提供帮助的方式:
- 报告问题:如果您遇到任何错误或有功能请求,请在我们的GitHub存储库上打开问题。
- 提交拉取请求:请随意分叉存储库,并提交带有增强功能或错误修复的pull请求。
- 代码风格:所有JavaScript代码都应该遵循 Bright Data的JavaScript编码规范这确保了整个代码库的一致性。
- 文档:我们始终感谢对文档的改进,包括本自述文件。
- 例子:通过提供示例来帮助其他用户,从而分享您的用例。
对于重大更改,请先打开一个问题来讨论您提出的更改。这可以确保您的时间得到充分利用,并与项目目标保持一致。
📞 支持
如果您遇到任何问题或有疑问,请联系Bright Data支持团队或在存储库中打开问题。