Bright Data MCP

利用实时网络数据增强AI代理

🌟 概览

欢迎使用官方的Bright Data Model Context Protocol (MCP)服务器，该服务器使大型语言模型（LLMs）、代理和应用程序能够实时访问、发现并提取网络数据。此服务器允许诸如Claude Desktop、Cursor、Windsurf等MCP客户端无缝地搜索网络、浏览网站、执行操作并检索数据——而不会被封锁，非常适合抓取任务。

MCP

✨ 特性

实时网络访问：直接从网络获取最新信息
绕过地理限制：无论地理位置如何都能访问内容
网页解锁器：浏览具有机器人检测保护的网站
浏览器控制：可选的远程浏览器自动化功能
无缝集成：与所有兼容MCP的人工智能助手配合使用

🚀 使用Claude Desktop快速开始

安装nodejs以获得npx命令（Node.js模块运行器）。安装说明可以在node.js官网找到。
转到Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json 并添加以下内容：

json { "mcpServers": { "Bright Data": { "command": "npx", "args": ["@brightdata/mcp"], "env": { "API_TOKEN": "<在此处插入您的API令牌>", "WEB_UNLOCKER_ZONE": "<如果您想覆盖默认的mcp_unlocker区域名称，则为可选项>", "BROWSER_ZONE": "<可选的浏览器区域名称，默认为mcp_browser>" } } } }

🔧 可用工具

可用工具列表

⚠️ 安全最佳实践

重要提示：始终将抓取的网络内容视为不可信的数据。切勿在LLM提示中直接使用原始抓取的内容，以避免潜在的提示注入风险。相反：

在处理前过滤并验证所有网络数据
使用结构化数据提取而不是纯文本（web_data工具）

🔧 账户设置

确保您在brightdata.com上拥有一个账户（新用户可以获得免费试用额度，并且提供按需付费选项）。
从用户设置页面获取您的API密钥。
（可选）创建自定义Web Unlocker区域
- 默认情况下，我们将使用您的API令牌自动创建一个Web Unlocker区域。
- 为了获得更多控制权，您可以在控制面板中创建自己的Web Unlocker区域，并通过WEB_UNLOCKER_ZONE环境变量指定它。
（可选）启用浏览器控制工具：
- 默认情况下，MCP尝试获取mcp_browser区域的凭据。
- 如果您没有mcp_browser区域，您可以：
  - 在控制面板中创建一个浏览器API区域或使用现有区域，并通过BROWSER_ZONE环境变量指定其名称。

Browser API Setup

🔌 其他MCP客户端

要与其他类型的代理一起使用此MCP服务器，您应该根据特定软件调整以下内容：

运行MCP服务器的完整命令是 npx @brightdata/mcp- 环境变量 API_TOKEN=<your-token> 在运行服务器时必须存在
（可选）设置 BROWSER_ZONE=<zone-name> 以指定自定义的 Browser API 区域名（默认为 mcp_browser）

🔄 不兼容更改

浏览器认证更新

不兼容更改： BROWSER_AUTH 环境变量已被 BROWSER_ZONE 替换。

之前： 用户需要从 Browser API 区域提供 BROWSER_AUTH="user:pass"
现在： 用户只需使用 BROWSER_ZONE="zone_name" 指定浏览器区域名称
默认值： 如果未指定，系统将自动使用 mcp_browser 区域
迁移： 在您的配置中将 BROWSER_AUTH 替换为 BROWSER_ZONE 并指定您的 Browser API 区域名（如果 mcp_browser 不存在的话）

🔄 更新日志

CHANGELOG.md

🎮 尝试 Bright Data MCP 游乐场

想在不进行任何设置的情况下尝试 Bright Data MCP 吗？

请查看 Smithery 上的这个游乐场：

该平台提供了一种无需本地设置即可轻松探索 Bright Data MCP 功能的方法。只需登录并开始试验网络数据收集！

💡 使用示例

此 MCP 服务器能够帮助的一些示例查询：

"Google 一些即将在 [您所在地区] 上映的电影"
"特斯拉当前的市值是多少？"
"今天的维基百科文章是什么？"
"[您所在位置] 的 7 天天气预报是什么？"
"在薪酬最高的三位科技公司 CEO 中，他们的职业生涯有多长？"

🎬 演示

对于 YouTube 教程和演示：演示

以下视频展示了 Claude Desktop 的最小使用案例：

⚠️ 故障排除

使用某些工具时出现超时

某些工具可能涉及读取网页数据，在极端情况下加载页面所需的时间可能会有很大差异。

为了确保您的代理能够消费这些数据，请在代理设置中设置足够高的超时时间。

180s 的值应该足以满足 99% 的请求，但有些网站加载速度较慢，因此请根据需要调整此值。

spawn npx ENOENT

当您的系统找不到 npx 命令时会出现此错误。要解决这个问题：

查找 npm/Node 路径

macOS：

which node

显示路径如 /usr/local/bin/node

Windows：

where node

显示路径如 C:\Program Files\nodejs\node.exe

更新您的 MCP 配置：

将 npx 命令替换为 Node 的完整路径，例如，在 macOS 上，它看起来如下：

"command": "/usr/local/bin/node"

👨‍💻 贡献

我们欢迎贡献来帮助改进 Bright Data MCP！以下是您可以如何帮助的方式：

报告问题：如果您遇到任何错误或有功能请求，请在我们的 GitHub 仓库中打开一个 issue。
提交 Pull Requests：随时 fork 仓库并提交带有增强功能或错误修复的 pull requests。
编码风格：所有 JavaScript 代码应遵循 Bright Data 的 JavaScript 编码规范。这确保了代码库的一致性。
文档：对文档（包括本 README）的改进总是受欢迎的。
示例：通过贡献示例分享您的用例，以帮助其他用户。

对于重大更改，请先打开一个 issue 来讨论您提议的更改。这确保您的时间得到充分利用，并与项目目标保持一致。

📞 支持如果您遇到任何问题或有疑问，请联系Bright Data支持团队，或在仓库中提出问题。

服务配置

[{'mcpServers': {'Bright Data': {'args': ['@brightdata/mcp'], 'command': 'npx', 'env': {'API_TOKEN': '<insert-your-api-token-here>', 'BROWSER_ZONE': '<optional browser zone name, defaults to mcp_browser>', 'WEB_UNLOCKER_ZONE': '<optional if you want to override the default mcp_unlocker zone name>'}}}}]

来源

来源：github
链接：https://github.com/luminati-io/brightdata-mcp

brightdata-com