Bright Data Mcp

创建者

brightdata•Jun 25, 2025

一个强大的模型上下文协议（MCP）服务器，提供一个一体化的公共网络访问解决方案。

# Mcp# Scraping# Web-scraping# Data-extraction# Data-collection# Structured-data# Web-crawling# Browser-automation# Ai-agents# Web-data# Scraping-tools# Anti-bot-detection# Llm# Ai-integrations# Mcp-server# Modelcontextprotocol

概览

什么是 Brightdata MCP？

Brightdata MCP（模型上下文协议）是一个强大的服务器，旨在提供公共网络访问的一体化解决方案。它使用户能够高效地管理和访问来自各种网络来源的数据，确保开发人员和企业的无缝集成和功能。

Brightdata MCP 的特点

综合数据访问：Brightdata MCP 允许用户轻松访问广泛的公共网络数据。
用户友好的界面：该平台设计了直观的界面，简化了导航和数据管理。
强大的安全性：Brightdata MCP 优先考虑用户安全，实施先进措施以保护敏感信息。
可扩展性：该服务器能够处理不同的负载，适合小型项目和大规模操作。
实时数据处理：用户可以实时访问和处理数据，提高决策能力和运营效率。

如何使用 Brightdata MCP

注册：在 Brightdata 网站上创建一个帐户以访问 MCP 服务器。
设置您的环境：按照文档配置您的开发环境，以优化 MCP 的使用。
与您的应用程序集成：使用提供的 API 将 Brightdata MCP 集成到您现有的应用程序或工作流程中。
访问数据：利用服务器根据您的项目需求获取和管理公共网络数据。
监控性能：定期检查 Brightdata 提供的性能指标，以确保高效运行。

常见问题解答

我可以通过 Brightdata MCP 访问哪些类型的数据？

Brightdata MCP 允许访问各种公共网络数据，包括但不限于社交媒体、电子商务和新闻网站。

Brightdata MCP 安全吗？

是的，Brightdata MCP 采用强大的安全措施来保护用户数据，并确保安全访问公共网络信息。

我可以扩展对 Brightdata MCP 的使用吗？

当然可以！Brightdata MCP 设计为可扩展，能够满足小型和大规模数据访问需求。

我如何获得 Brightdata MCP 的支持？

用户可以通过 Brightdata 网站访问支持，那里提供文档和客户服务选项。

使用 Brightdata MCP 是否需要费用？

Brightdata 提供基于使用和功能的多种定价计划。建议查看他们的官方网站以获取详细的定价信息。

详情

<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">Enhance AI Agents with Real-Time Web Data</h3> <div align="center"> <p align="center"> <img src="https://img.shields.io/npm/v/@brightdata/mcp?label=version" alt="npm version"/> </p> <p align="center"> <img src="https://img.shields.io/npm/dw/@brightdata/mcp" alt="npm downloads"/> <a href="https://smithery.ai/server/@luminati-io/brightdata-mcp"> <img src="https://smithery.ai/badge/@luminati-io/brightdata-mcp" alt="Smithery score"/> </a> </p> </div>

🌟 Overview

Welcome to the official Bright Data Model Context Protocol (MCP) server, enabling LLMs, agents and apps to access, discover and extract web data in real-time. This server allows MCP clients, such as Claude Desktop, Cursor, Windsurf and others, to seamlessly search the web, navigate websites, take action and retrieve data - without getting blocked - perfect for scraping tasks.

MCP

🎬 Demo

The videos below demonstrate a minimal use case for Claude Desktop:

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

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

For YouTube tutorials and demos: Demo

✨ Features

Real-time Web Access: Access up-to-date information directly from the web
Bypass Geo-restrictions: Access content regardless of location constraints
Web Unlocker: Navigate websites with bot detection protection
Browser Control: Optional remote browser automation capabilities
Seamless Integration: Works with all MCP-compatible AI assistants

🚀 Quickstart with Claude Desktop

Install nodejs to get the npx command (node.js module runner). Installation instructions can be found on the node.js website
Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:

{
  "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_ZONE": "<optional browser zone name, defaults to mcp_browser>"
        "RATE_LIMIT": "<optional rate limit format: limit/time+unit, e.g., 100/1h, 50/30m, 10/5s>"
      }
    }
  }
}

🔧 Available Tools

List of Available Tools

⚠️ Security Best Practices

Important: Always treat scraped web content as untrusted data. Never use raw scraped content directly in LLM prompts to avoid potential prompt injection risks. Instead:

Filter and validate all web data before processing
Use structured data extraction rather than raw text (web_data tools)

🔧 Account Setup

Make sure you have an account on brightdata.com (new users get free credit for testing, and pay as you go options are available)
Get your API key from the user settings page
(Optional) Create a custom Web Unlocker zone
- By default, we create a Web Unlocker zone automatically using your API token
- For more control, you can create your own Web Unlocker zone in your control panel and specify it with the WEB_UNLOCKER_ZONE environment variable
(Optional) To enable browser control tools:
- By default, the MCP tries to fetch credentials of mcp_browser zone.
- If you don't have an mcp_browser zone, you can :
  - Create a Browser API zone in your control panel or use an existing one and specify its name using the BROWSER_ZONE environment variable
(Optional) Configure rate limiting:
- Set the RATE_LIMIT environment variable to control API usage
- Format: limit/time+unit (e.g., 100/1h for 100 calls per hour)
- Supported time units: seconds (s), minutes (m), hours (h)
- Examples: RATE_LIMIT=100/1h, RATE_LIMIT=50/30m, RATE_LIMIT=10/5s
- Rate limiting is session-based (resets when server restarts)

Browser API Setup

🔌 Other MCP Clients

To use this MCP server with other agent types, you should adapt the following to your specific software:

The full command to run the MCP server is npx @brightdata/mcp
The environment variable API_TOKEN=<your-token> must exist when running the server
(Optional) Set BROWSER_ZONE=<zone-name> to specify a custom Browser API zone name (defaults to mcp_browser)

🔄 Breaking Changes

Browser Authentication Update

BREAKING CHANGE: The BROWSER_AUTH environment variable has been replaced with BROWSER_ZONE.

Before: Users needed to provide BROWSER_AUTH="user:pass" from the Browser API zone
Now: Users only need to specify the browser zone name with BROWSER_ZONE="zone_name"
Default: If not specified, the system uses mcp_browser zone automatically
Migration: Replace BROWSER_AUTH with BROWSER_ZONE in your configuration and specify your Browser API zone name if mcp_browser doesn't exists

🔄 Changelog

CHANGELOG.md

🎮 Try Bright Data MCP Playgrounds

Want to try Bright Data MCP without setting up anything?

Check out this playground on Smithery:

This platform provide an easy way to explore the capabilities of Bright Data MCP without any local setup. Just sign in and start experimenting with web data collection!

💡 Usage Examples

Some example queries that this MCP server will be able to help with:

"Google some movies that are releasing soon in [your area]"
"What's Tesla's current market cap?"
"What's the Wikipedia article of the day?"
"What's the 7-day weather forecast in [your location]?"
"Of the 3 highest paid tech CEOs, how long have their careers been?"

⚠️ Troubleshooting

Timeouts when using certain tools

Some tools can involve reading web data, and the amount of time needed to load the page can vary by quite a lot in extreme circumstances.

To ensure that your agent will be able to consume the data, set a high enough timeout in your agent settings.

A value of 180s should be enough for 99% of requests, but some sites load slower than others, so tune this to your needs.

spawn npx ENOENT

This error occurs when your system cannot find the npx command. To fix it:

Finding npm/Node Path

macOS:

which node

Shows path like /usr/local/bin/node

Windows:

where node

Shows path like C:\Program Files\nodejs\node.exe

Update your MCP configuration:

Replace the npx command with the full path to Node, for example, on mac, it will look as follows:

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

👨‍💻 Contributing

We welcome contributions to help improve the Bright Data MCP! Here's how you can help:

Report Issues: If you encounter any bugs or have feature requests, please open an issue on our GitHub repository.
Submit Pull Requests: Feel free to fork the repository and submit pull requests with enhancements or bug fixes.
Coding Style: All JavaScript code should follow Bright Data's JavaScript coding conventions. This ensures consistency across the codebase.
Documentation: Improvements to documentation, including this README, are always appreciated.
Examples: Share your use cases by contributing examples to help other users.

For major changes, please open an issue first to discuss your proposed changes. This ensures your time is well spent and aligned with project goals.

📞 Support

If you encounter any issues or have questions, please reach out to the Bright Data support team or open an issue in the repository.

Server配置

{
  "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_ZONE": "<optional browser zone name, defaults to mcp_browser>"
        "RATE_LIMIT": "<optional rate limit format: limit/time+unit, e.g., 100/1h, 50/30m, 10/5s>"
      }
    }
  }
}