实时网络数据服务

Bright Data MCP 是一个实时网络数据访问服务,专为AI代理和应用设计,提供网页数据抓取、地理限制绕过和浏览器自动化功能。

  • by makaronz
  • 本地部署
  • 更新于
在 GitHub 查看 makaronz/brightdata-mcp

使用说明

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快速入门

  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>",
        "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工具)

🔧 帐户设置

  1. 确保你有一个帐户 brightdata.com (新用户可获得免费测试积分,并提供按需付费选项)

  2. 从获取API密钥 用户设置页面

  3. (可选)创建自定义Web解锁器区域

    • 默认情况下,我们使用您的API令牌自动创建Web解锁器区域
    • 为了获得更多控制,您可以在您的 控制面板 并用 WEB_UNLOCKER_ZONE 环境变量
  4. (可选)要启用浏览器控制工具,请执行以下操作:

    • 访问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做出贡献!以下是您可以提供帮助的方式:

  1. 报告问题:如果您遇到任何错误或有功能请求,请在我们的GitHub存储库上打开问题。
  2. 提交拉取请求:请随意分叉存储库,并提交带有增强功能或错误修复的pull请求。
  3. 代码风格:所有JavaScript代码都应该遵循 Bright Data的JavaScript编码规范这确保了整个代码库的一致性。
  4. 文档:我们始终感谢对文档的改进,包括本自述文件。
  5. 例子:通过提供示例来帮助其他用户,从而分享您的用例。

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

📞 支持

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