brightdata-mcp

环境要求

• Bright Data 账号，并在账户设置页获取 API Token（新账号每月 5000 次免费请求，无需信用卡）
• 任意支持 MCP 的客户端，如 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Gemini CLI、Ze
• 若使用本地 npx 方式，需要能运行 npx 命令的环境（Node.js 环境）

安装与启动步骤

1. 1获取 API Token

   注册登录 Bright Data 账号，进入账户设置页（brightdata.com/cp/setting/users）创建并复制 API Token，后续所有配置都用它。

2. 2命令行添加托管服务

   Claude Code 用户可直接用一条命令接入官方托管服务器，把 token 换成自己的 API Token，无需本地安装任何东西。

   claude mcp add --transport http brightdata "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"

   复制

3. 3图形界面客户端添加

   Claude Desktop 走 Settings → Connectors → Add custom connector，名称填 Bright Data，URL 填下方地址后点击 Add 即可。

   https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN

   复制

4. 4编辑客户端配置文件

   Cursor 等客户端需在配置文件中填入托管 URL，把 YOUR_API_TOKEN 替换成真实 Token 后保存并重启客户端。

   {
     "mcpServers": {
       "brightdata": {
         "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
       }
     }
   }

   复制

5. 5改用本地 npx 方式

   不想用托管服务时，可在客户端配置中改为 npx 启动 @brightdata/mcp，并通过 env 传入 API_TOKEN。

   {
     "mcpServers": {
       "Bright Data": {
         "command": "npx",
         "args": ["@brightdata/mcp"],
         "env": {
           "API_TOKEN": ""
         }
       }
     }
   }

   复制

6. 6按需启用工具组

   默认加载全部 69 个工具，可通过 GROUPS 只启用需要的分组（如 browser、advanced_scraping、code），或用 TOOLS 只启用单个工具。

   {
     "mcpServers": {
       "Bright Data": {
         "command": "npx",
         "args": ["@brightdata/mcp"],
         "env": {
           "API_TOKEN": "",
           "GROUPS": "browser,advanced_scraping",
           "TOOLS": "extract"
         }
       }
     }
   }

   复制

7. 7配置高级参数

   如需限流、自定义解锁区域或浏览器区域、调整轮询超时，可在 env 中追加对应变量，按下方示例填写。

   {
     "mcpServers": {
       "Bright Data": {
         "command": "npx",
         "args": ["@brightdata/mcp"],
         "env": {
           "API_TOKEN": "your-token-here",
           "RATE_LIMIT": "100/1h",
           "WEB_UNLOCKER_ZONE": "custom",
           "BROWSER_ZONE": "custom_browser",
           "POLLING_TIMEOUT": "600"
         }
       }
     }
   }

   复制

关键配置

如何确认成功

在 MCP 客户端中确认 Bright Data 连接成功并列出工具（如 search_engine、scrape_as_markdown），再让它抓取一个网页验证。

常见问题

注意事项

• 托管方式无需安装，直接使用 https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN 即可，注意别把 Token 泄露到公开仓库。
• 本地 npx 方式需要在客户端配置的 env 中提供 API_TOKEN，否则无法鉴权。
• 默认暴露 69 个工具，工具过多时可先用 GROUPS 或 TOOLS 精简，减少对模型的上下文占用。
• README 未给出的包名、端口和路径不要臆造，配置只按官方示例填写。