# brightdata-com
## 基本信息
- Slug: `brightdata-com-brightdata-mcp`
- Source: modelscope
- Publisher: @brightdata-com/brightdata-mcp
- Categories: web-scraping / browser-automation / search
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@brightdata-com/brightdata-mcp
## 简介
暂无描述。
## MCP Server 详情

<p align="center">
  <a href="https://brightdata.com/">
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/logo/light.svg" width="300" alt="Bright Data Logo">
  </a>
</p>

<h1 align="center">Bright Data MCP</h1>
<h3 align="center">利用实时网络数据增强AI代理</h3>

<div align="center">
  
[![smithery badge](https://smithery.ai/badge/@luminati-io/brightdata-mcp)](https://smithery.ai/server/@luminati-io/brightdata-mcp) 
<a href="https://glama.ai/mcp/servers/@luminati-io/brightdata-mcp">
  <img width="200" src="https://glama.ai/mcp/servers/@luminati-io/brightdata-mcp/badge" alt="Bright Data MCP server" />
</a>

</div>

## 🌟 概览

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

![MCP](https://github.com/user-attachments/assets/b949cb3e-c80a-4a43-b6a5-e0d6cec619a7)

## ✨ 特性

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

## 🚀 使用Claude Desktop快速开始

1. 安装`nodejs`以获得`npx`命令（Node.js模块运行器）。安装说明可以在[node.js官网](https://nodejs.org/en/download)找到。

2. 转到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>"
      }
    }
  }
}


## 🔧 可用工具

[可用工具列表](https://github.com/brightdata-com/brightdata-mcp/blob/main/assets/Tools.md)

## ⚠️ 安全最佳实践

**重要提示**：始终将抓取的网络内容视为不可信的数据。切勿在LLM提示中直接使用原始抓取的内容，以避免潜在的提示注入风险。
相反：
- 在处理前过滤并验证所有网络数据
- 使用结构化数据提取而不是纯文本（web_data工具）

## 🔧 账户设置

1. 确保您在[brightdata.com](https://brightdata.com)上拥有一个账户（新用户可以获得免费试用额度，并且提供按需付费选项）。

2. 从[用户设置页面](https://brightdata.com/cp/setting/users)获取您的API密钥。

3. （可选）创建自定义Web Unlocker区域
   - 默认情况下，我们将使用您的API令牌自动创建一个Web Unlocker区域。
   - 为了获得更多控制权，您可以在[控制面板](https://brightdata.com/cp/zones)中创建自己的Web Unlocker区域，并通过`WEB_UNLOCKER_ZONE`环境变量指定它。

4. （可选）启用浏览器控制工具：
   - 默认情况下，MCP尝试获取`mcp_browser`区域的凭据。
   - 如果您没有`mcp_browser`区域，您可以：
     - 在[控制面板](https://brightdata.com/cp/zones)中创建一个浏览器API区域或使用现有区域，并通过`BROWSER_ZONE`环境变量指定其名称。

![Browser API Setup](https://github.com/user-attachments/assets/cb494aa8-d84d-4bb4-a509-8afb96872afe)

## 🔌 其他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](https://github.com/brightdata-com/brightdata-mcp/blob/main/CHANGELOG.md)

## 🎮 尝试 Bright Data MCP 游乐场

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

请查看 [Smithery](https://smithery.ai/server/@luminati-io/brightdata-mcp/tools) 上的这个游乐场：

[![2025-05-06_10h44_20](https://github.com/user-attachments/assets/52517fa6-827d-4b28-b53d-f2020a13c3c4)](https://smithery.ai/server/@luminati-io/brightdata-mcp/tools)

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

## 💡 使用示例

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

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

## 🎬 演示

对于 YouTube 教程和演示：[演示](https://github.com/brightdata-com/brightdata-mcp/blob/main/examples/README.md)

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

![演示](https://github.com/brightdata-com/brightdata-mcp/blob/main/assets/Demo3.gif)
![演示](https://github.com/brightdata-com/brightdata-mcp/blob/main/assets/Demo.gif)

## ⚠️ 故障排除

### 使用某些工具时出现超时

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

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

`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！以下是您可以如何帮助的方式：

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

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

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