brightdata

🌟 概述

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

目录

• 🎬 演示
• ✨ 特性
• 💡 使用示例
• 🚀 Claude Desktop快速入门
• 🔧 可用工具
• ⚠️ 安全最佳实践
• 🔧 账户设置
• 🔌 其他MCP客户端
• 🎮 尝试Bright Data MCP游乐场
• ⚠️ 故障排除
• 👨‍💻 贡献
• 📞 支持

🎬 演示

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

https://github.com/user-attachments/assets/59f6ebba-801a-49ab-8278-1b2120912e33

https://github.com/user-attachments/assets/61ab0bee-fdfa-4d50-b0de-5fab96b4b91d

YouTube教程和演示：演示

✨ 特性

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

💡 使用示例

一些示例查询，此MCP服务器可以提供帮助：

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

🚀 Claude Desktop快速入门

通过Claude Desktop扩展程序：

1. 下载 Claude Desktop扩展程序：
   📦 Bright Data的MCP扩展程序

2. 打开 Claude并进入：
   设置 → 扩展程序

3. 将步骤1中的.dtx文件拖到放置区域。

4. 启用服务并重启 Claude。

5. 开始享受吧！

通过claude_desktop_config.json：

1. 安装nodejs以获取npx命令（Node.js模块运行器）。安装说明可以在node.js官网找到。

2. 进入Claude > 设置 > 开发者 > 编辑配置 > 编辑"claude_desktop_config.json"以包含以下内容：

{

  "mcpServers": {

    "Bright Data": {

      "command": "npx",

      "args": ["@brightdata/mcp"],

      "env": {

        "API_TOKEN": "<insert-your-api-token-here>"

      }

    }

  }

}

🛸 或者更多高级选项：

{

  "mcpServers": {

    "Bright Data": {

      "command": "npx",

      "args": ["@brightdata/mcp"],

      "env": {

        "API_TOKEN": "<insert-your-api-token-here>",

        "RATE_LIMIT": "<optional if you want to change rate limit format: limit/time+unit, e.g., 100/1h, 50/30m, 10/5s>",

        "WEB_UNLOCKER_ZONE": "<optional if you want to override the web unlocker zone name - default is mcp_unlocker>",

        "BROWSER_ZONE": "<optional if you want to override the browser zone name - defaults is mcp_browser>"

      }

    }

  }

}

🔧 可用工具

可用工具列表

⚠️ 安全最佳实践

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

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

🔧 账户设置

1. 确保您在 brightdata.com 上有一个账户（新用户可以获得免费测试额度，并且有按需付费选项）

2. 从 用户设置页面 或您收到的欢迎邮件中获取您的 API 密钥

可选：

1. 配置速率限制：

   • 设置 RATE_LIMIT 环境变量以控制 API 使用
   • 格式：limit/time+unit（例如，100/1h 表示每小时 100 次调用）
   • 支持的时间单位：秒 (s)，分钟 (m)，小时 (h)
   • 示例：RATE_LIMIT=100/1h，RATE_LIMIT=50/30m，RATE_LIMIT=10/5s
   • 速率限制是基于会话的（服务器重启时重置）

2. 创建自定义 Web Unlocker 区域

   • 默认情况下，我们会使用您的 API 令牌自动创建一个 Web Unlocker 区域
   • 为了获得更多控制权，您可以在 控制面板 中创建自己的 Web Unlocker 区域，并通过 WEB_UNLOCKER_ZONE 环境变量指定它

3. 创建自定义 Browser API 区域：

   • 默认情况下，我们会使用您的 API 令牌自动创建一个 Browser API 区域。
   • 为了获得更多控制权，您可以在 控制面板 中创建自己的 Browser API 区域，并通过 BROWSER_ZONE 环境变量指定它

🔌 其他 MCP 客户端

要将此 MCP 服务器与其他代理类型一起使用，请根据您的特定软件进行以下调整：

• 在运行服务器之前，请确保设置了 API_TOKEN=<your-token> 环境变量
• 运行 MCP 服务器的完整命令是 npx @brightdata/mcp

💻 macOS / Linux (bash/zsh)

export API_TOKEN=your-token

npx @brightdata/mcp

🪟 Windows (命令提示符)

set API_TOKEN=your-token

npx @brightdata/mcp

🪟 Windows (PowerShell)

$env:API_TOKEN="your-token"

npx @brightdata/mcp

💡 提示: 您还可以使用 .env 文件和类似 dotenv 的工具来更轻松地管理开发期间的环境变量。

🔄 更新日志

CHANGELOG.md

🎮 尝试 Bright Data MCP 演示

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

请查看 Smithery 上的这个演示：

该平台提供了一种简单的方法来探索 Bright Data MCP 的功能，而无需任何本地设置。只需登录并开始实验网页数据收集！

⚠️ 故障排除

使用某些工具时出现超时

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

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

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 的完整路径，例如，在 Mac 上，看起来如下：

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

👨‍💻 贡献

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

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

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

📞 支持

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