Bright Data MCP

🌟 概述

欢迎使用 Bright 数据模型上下文协议 (MCP) 官方服务器，它使 LLM、代理和应用程序能够实时访问、发现和提取网络数据。此服务器允许 Claude Desktop、Cursor、Windsurf 等 MCP 客户端无缝搜索网络、浏览网站、执行操作并检索数据，且不会受到任何阻止，非常适合数据抓取任务。

✨ 特点

• 实时网络访问：直接从网络访问最新信息
• 绕过地理限制：不受位置限制访问内容
• Web Unlocker ：使用机器人检测保护浏览网站
• 浏览器控制：可选的远程浏览器自动化功能
• 无缝集成：可与所有兼容 MCP 的 AI 助手配合使用

🚀 使用 Claude Desktop 快速入门

1. 安装nodejs以获取npx命令（node.js 模块运行器）。安装说明可在node.js 网站上找到
2. 转到 Claude > 设置 > 开发人员 > 编辑配置 > claude_desktop_config.json 以包含以下内容：

🔧 可用工具

可用工具列表

⚠️ 安全最佳实践

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

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

🔧 账户设置

1. 确保您在brightdata.com上有一个帐户（新用户可获得免费测试积分，并可选择按需付费）
2. 从用户设置页面获取您的 API 密钥
3. （可选）创建自定义 Web Unlocker 区域
   • 默认情况下，我们会使用您的 API 令牌自动创建 Web Unlocker 区域
   • 为了更好地控制，您可以在控制面板中创建自己的 Web Unlocker 区域，并使用WEB_UNLOCKER_ZONE环境变量指定它
4. （可选）要启用浏览器控制工具：
   • 访问 Bright Data 控制面板： brightdata.com/cp/zones
   • 创建一个新的“浏览器 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 Playgrounds

想要尝试 Bright Data MCP 而无需进行任何设置吗？

看看Smithery上的这个游乐场：

此平台让您轻松探索 Bright Data MCP 的功能，无需任何本地设置。只需登录即可开始体验 Web 数据收集！

💡 使用示例

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

• “用 Google 搜索一些即将在 [您所在地区] 上映的电影”
• “特斯拉目前的市值是多少？”
• “今天的维基百科文章是什么？”
• “[您所在位置] 未来 7 天的天气预报如何？”
• “在收入最高的三位科技公司 CEO 中，他们的职业生涯有多长？”

🎬 演示

YouTube 教程和演示：演示

下面的视频演示了 Claude Desktop 的一个最小用例：

⚠️ 故障排除

使用某些工具时超时

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

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

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

生成 npx ENOENT

当您的系统找不到npx命令时，就会发生此错误。解决方法如下：

查找 npm/Node 路径

macOS：

显示类似/usr/local/bin/node路径

视窗：

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

更新您的 MCP 配置：

将npx命令替换为 Node 的完整路径，例如，在 Mac 上，它将如下所示：

👨‍💻 贡献

欢迎您为 Bright Data MCP 的改进贡献力量！您可以通过以下方式提供帮助：

1. 报告问题：如果您遇到任何错误或有功能请求，请在我们的 GitHub 存储库上打开一个问题。
2. 提交拉取请求：请随意分叉存储库并提交具有增强功能或错误修复的拉取请求。
3. 编码风格：所有 JavaScript 代码都应遵循Bright Data 的 JavaScript 编码约定。这确保了整个代码库的一致性。
4. 文档：我们始终欢迎对文档（包括本自述文件）的改进。
5. 示例：通过贡献示例来分享您的用例，以帮助其他用户。

对于重大变更，请先创建 issue 讨论您提议的变更。这可以确保您的时间得到充分利用，并与项目目标保持一致。

📞 支持

如果您遇到任何问题或有疑问，请联系 Bright Data 支持团队或在存储库中打开问题。