Blog / AI
AI

Bright Data Web MCP 在 VS Code 与 Kilo Code 中的集成

按照本分步指南,将 Bright Data 的 Web MCP 连接到 VS Code 的 Kilo Code,让你的 AI 编码助手能够访问并使用实时网页数据。
3 分钟阅读
Kilo Code × Bright Data 的 MCP 集成

在本教程中,你将学到:

  • 什么是 Kilo Code,以及为什么它是 VS Code 的强大 AI 编码助手。
  • 为何集成网页数据能力(通过 Bright Data 的 Web MCP)能让 Kilo Code 更加实用。
  • 如何将 Kilo Code 与 Bright Data 的 Web MCP 按步骤连接,打造一个具备实时网页访问能力的增强型 AI 编码代理。

让我们开始吧!

准备工作

要跟上本教程,你需要:

  • Visual Studio Code(建议使用最新版本)。
  • 已安装 Node.js 与 npm(Bright Data Web MCP 以 npm 包形式分发)。
  • 一个 Bright Data 账户与 API Key
  • 任一 LLM 提供商的 API Key。Kilo Code 支持多家提供商(OpenAI、Anthropic 等)。
  • (可选)Python。仅在你想运行测试中由 Kilo Code 生成的示例 Python 脚本时需要。

如果你还没有 Bright Data 的 API Key,不用担心,我们会带你创建。在此之前,先看看 Kilo Code 到底是什么。

什么是 Kilo Code(以及集成 Kilo Code 的 VS Code)?

Kilo Code 是一个开源 AI 编码助手,以 VS Code 扩展的形式运行,结合了 Cline、Roo Code 等流行工具的优点,并在此基础上做了独特增强。

它就像把一个完整的 AI 开发团队装进了编辑器,能用自然语言帮助你生成代码、重构、调试,甚至自动化任务。概括来说,它可以:

  • 充当 AI 结对程序员,你可以用英文与之对话以规划或编写代码。
  • 读取你的项目文件、进行修改,甚至在需要时创建新文件或执行终端命令。
  • 通过多种模式调整其“个性”——例如 ArchitectCoderDebugger 模式分别引导 AI 在规划、编码或排错时的行为。
  • 集成多种 AI 模型提供商(OpenAI、Anthropic、OpenRouter、本地 LLM 如 Ollama 等),可自行选择底层模型。
  • 通过 模型上下文协议(MCP,Model Context Protocol) 连接外部工具,让 Kilo Code 使用 Web API 和自定义服务来扩展功能。

Kilo Code 构建在其他开源项目之上(它源自 Roo CodeCline 代理),但目前已走出自己的道路。它支持 400+ 款 AI 模型,包括 Gemini 2.5 Pro、Claude 4 Sonnet & Opus、GPT-5,并允许连接外部 API 与数据源,是进行网页数据集成的理想平台。

为何要把 Web MCP 集成进 Kilo Code?

和所有 AI 编码助手一样,驱动 Kilo Code 的大语言模型(LLM)也面临知识过时问题

LLM 只能基于其训练时的静态数据来生成答案,本质上是对过去的一次快照。这意味着 AI 可能会错过新的框架、建议使用过时函数,或给出不符合最新最佳实践的代码。

想象一下,如果让你的 Kilo Code 代理具备从网页获取最新教程、文档与示例并实时学习的能力。通过集成网页搜索与实时数据提取,Kilo Code 就能用当前信息解决问题。例如,拉取刚发布的库文档,或针对错误消息获取最新的 Stack Overflow 答案。

这正是 Bright Data 的 Web MCP 服务器所能实现的。

Bright Data 的 Web MCP 服务器是一个强大的 Model Context Protocol 实现,为公共网页访问提供一体化方案,现在提供每月 5,000 次请求的免费层

换句话说,它就像一个“网页浏览器 + 数据抓取器”,由 Kilo Code 的 AI 以编程方式控制。MCP 服务器通过简单 API 暴露工具,用于搜索互联网、浏览网站、提取结构化数据。最常用的 MCP 工具有:

  • search_engine:用于执行实时网页搜索(Google、Bing 或 Yandex),并以 JSON/Markdown 格式返回搜索结果(标题、摘要、URL)。这样 AI 就能实时找到相关网页或答案。关于所有用例,如何选择最佳 SERP API 工具请看这里
  • scrape_as_markdown:用于获取任意网页内容,支持绕过机器人与 CAPTCHA,并以干净的Markdown 格式返回文本。这样 AI 就能阅读文章或文档页面,并用这些信息协助你的任务。

将 Kilo Code 连接到 Bright Data 的 MCP,相当于给你的 AI 程序员装上了网页的“眼睛与双手”。它能在工作流中搜索、点击和抓取,使其更高效、更准确。下面我们来一步步完成配置。

如何在 Visual Studio Code 中将 Kilo Code 连接到 Bright Data 的 Web MCP

步骤 #1:在 VS Code 中安装 Kilo Code

通过VS Code 扩展市场安装 Kilo Code 十分简单。打开 VS Code,进入扩展面板。安装完成后,可能会提示你重载 VS Code 以激活扩展。此时你应能在侧边栏(通常在左侧)看到 Kilo Code 图标。

安装 Kilo Code

步骤 #2:配置你的 LLM 提供商

安装后,点击侧边栏中的 Kilo Code 图标打开主面板。界面会显示在 VS Code 左侧,提供对 Kilo Code 所有功能与配置选项的访问。

Kilo Code 提供多种访问 AI 模型的方式,满足不同偏好与预算的用户。

  • 对新用户而言,最便捷的方式是使用内置积分系统。在 Kilo Code 面板点击 “Connect with Google” 登录你的账号。完成后会自动获得 20 美元免费积分,无需单独配置 API Key 即可立即访问 400+ AI 模型
  • 或者,如果你更愿意使用自己的 API Key,点击 Kilo Code 侧栏的齿轮图标进入 Model Providers,添加各提供商的 API Key,例如 Anthropic(Claude)、OpenAI(GPT)、Google(Gemini),或任一 OpenRouter 兼容服务。

配置好模型提供商后,花点时间选择你偏好的模型。例如,复杂推理任务选 GPT-4,细致代码分析选 Claude-3,多模态场景选 Gemini。

配置 Kilo Code

为确认一切正常,发一条简单测试消息,如 “Hello, can you help me code?”。AI 应能快速回应,表明模型连接正常。

步骤 #3:安装 Bright Data 的 Web MCP

现在 Kilo Code 已配置好 AI 模型,你可以为其扩展网页浏览与数据提取的能力。

  1. 在安装 MCP 服务器之前,你需要先获取 Bright Data API Token。访问 brightdata.com 注册免费账号,前三个月包含每月 5,000 次免费请求。创建账号后按提示验证邮箱。
  2. 登录后,进入账号设置找到并复制你的 API Token。该 Token 用作 MCP 服务器认证凭据,下一步配置会用到。请妥善保管,稍后要用到。
  3. 准备就绪后,打开终端/命令行,在系统范围内全局安装 Bright Data Web MCP:
npm install -g @brightdata/mcp

全局安装可确保 MCP 服务器在系统任意位置均可被 Kilo Code 访问。

验证安装是否成功:

npx @brightdata/mcp --version

你应看到2.5.0 或更高版本,表示 MCP 服务器已正确安装并可用。

步骤 #4:将 Kilo Code 连接到 Web MCP

接下来是关键一步:把 Kilo Code 连接到刚安装好的 Bright Data Web MCP 服务器。Kilo Code 支持 STDIOSSE 两种 MCP 传输方式,我们将使用 STDIO 以获得本地最佳性能与稳定性。

在 Kilo Code 面板,点击齿轮图标进入 MCP Servers。找到 “Edit Global MCP” 打开配置文件,在此以 JSON 格式定义(可同时配置多个)MCP 服务器连接。

编辑 MCP 服务器配置

添加以下配置以连接 Bright Data 的 Web MCP:

{
  "mcpServers": {
    "Bright Data Web": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "YOUR_BRIGHT_DATA_API_TOKEN_HERE"
      },
      "disabled": false,
      "alwaysAllow": ["search_engine", "scrape_as_markdown"],
      "timeout": 180
    }
  }
}

"YOUR_BRIGHT_DATA_API_TOKEN_HERE" 替换为你从 Bright Data 账户复制的实际 Token。"alwaysAllow" 预先允许基础搜索与抓取工具,减少日常使用时的阻力;timeout 设为 180 秒,以避免较慢抓取时过早超时。

如需对 MCP 行为进行更精细控制,Bright Data 提供多项高级配置。下面的扩展配置为企业用户或有特殊需求的用户提供额外灵活性:

{
  "mcpServers": {
    "Bright Data Web": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "YOUR_BRIGHT_DATA_API_TOKEN_HERE",
        "RATE_LIMIT": "100/1h",
        "PRO_MODE": "false",
        "WEB_UNLOCKER_ZONE": "optional_custom_zone",
        "BROWSER_ZONE": "optional_custom_browser_zone"
      },
      "disabled": false,
      "timeout": 180
    }
  }
}

限流可用如 "100/1h"(每小时 100 次)、"50/30m"(每 30 分钟 50 次)、"10/5s"(每 5 秒 10 次)等格式控制请求频率。将 PRO_MODE 设为 "true" 可解锁 60 款高级工具,但可能超出免费层并产生额外费用。zone 配置为可选,主要供有自定义代理需求的企业用户使用。

为提升安全性与便于管理,建议用环境变量存储 API Token,而非在配置文件中硬编码。在项目根目录创建 .env 文件:

API_TOKEN=your_actual_api_token_here
RATE_LIMIT=100/1h
PRO_MODE=false

然后在 MCP 配置中以 ${VARIABLE_NAME} 的形式引用变量。此方式可以避免敏感凭据出现在配置文件中,并便于在开发、预发、生产环境间切换。

对于团队协作或远程开发场景,若本地安装 MCP 不便,Bright Data 还提供 远程 SSE 传输选项:

{
  "mcpServers": {
    "Bright Data Remote": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE"
      ],
      "disabled": false,
      "timeout": 300
    }
  }
}

该配置直接连接到 Bright Data 托管的 MCP 端点,无需本地安装服务器,且具备相同功能。

默认配置使用 Bright Data 的免费层,包含 search_enginescrape_as_markdown 等基础工具,足以应对大多数网页数据集成需求,并享有 每月 5,000 次请求额度。

若启用 PRO_MODE,你将获得对 全部 60 款专用工具的访问,包括高级浏览器自动化与结构化数据提取能力,但可能在免费层限额之外产生费用。

保存配置(Ctrl+SCmd+S)后,完整重启 VS Code 以确保新 MCP 服务器被正确加载。重启后在 Kilo Code 的 MCP 设置面板中应能看到 “Bright Data Web”,并显示 “Running” 状态,表示连接成功。

步骤 #5:测试增强后的 Kilo Code 代理

完成 Kilo Code 与 Bright Data Web MCP 的集成后,是时候验证一切是否正常运行了。

打开 Kilo Code 面板,确认 MCP 服务器连接为激活状态。留意连接指示或状态信息,以确认 Bright Data Web 服务器已正常运行。

要进行更进阶的抓取功能测试,试试这个请求:“获取 CoinGecko 当前的比特币价格,并为 requests 库创建一份速查表。”这个测试会调用 scrape_as_markdown 工具,并展示实时文档访问的强大之处。

你应会看到抓取工具的授权提示,随后从实时的 CoinGecko 网页提取内容,并最终生成包含最新示例与函数签名的速查表。

高级用例与示例

该集成让你的 AI 助手可从 Stack Overflow、在线 API 文档、最新的 GitHub 讨论中获取当前解决方案,支持动态问题求解。你可以用 Kilo Code + Bright Data 的组合来实现:

  • 动态 API 文档集成
  • 实时市场数据分析
  • 竞品分析自动化

企业团队可通过强大的数据集成来自动化商业智能。金融服务可用诸如 “跟踪主流交易所的加密货币价格并创建交易看板。” 的请求来监控实时市场数据。营销团队可通过 “监控竞品定价页面并在变更时告警。” 来自动化竞品分析。

这些应用能将日常业务任务转化为自动化、由 AI 驱动的流程,输出可操作的洞察。

故障排查与技巧

即使文档完善,首次把 Kilo Code 与 Bright Data 的 Web MCP 连起来时,遇到小问题也很常见。好消息是,多数问题在知道关注点后都很容易诊断并修复。

常见安装问题

  • 如果安装后 Kilo Code 面板没有出现,首先尝试重启 VS Code。确保你在使用最新版本的 VS Code,旧版本有时会导致扩展无法正确加载。
  • 另一个常见“坑”是API 配置。若你粘贴的 LLM 提供商 Key 有误,或选择了你无权限访问的模型,Kilo Code 可能表现为无响应。务必再次核对 API Key,并发送如 “Hello” 的快速测试请求,确认模型可正常响应。
  • 在 MCP 侧,最常见的是连接与认证问题。如果服务器状态为 “Failed”,请先用 node --version 确认已安装 Node.js 18+,然后重装 MCP 服务器:
npm uninstall -g @brightdata/mcp && npm install -g @brightdata/mcp

认证错误通常源于 API Token 不正确——复制时避免多余空格,并确认你的 Bright Data 账户仍有可用额度。

  • Windows 用户可尝试替代配置:将 command 改为 "cmd"args 改为 ["/c", "npx", "-y", "@brightdata/mcp"]
  • 对于复杂网站的超时问题,可将超时时间提高到 300 秒,并考虑为 JavaScript 较重的页面启用专业模式(Pro Mode)

性能优化

一切运行稳定后,可进一步优化性能。

  • 记住每次 MCP 调用都需要往返访问网络,因此抓取多页等任务自然比纯本地生成慢。为保持响应迅速,请在提示中尽量具体。比如别让 Kilo Code “搜索所有 Python 相关内容”,而是限定为“搜索官方 Python 3.12 发布日志”。
  • 可对常用工具设置选择性自动批准来优化体验。例如将 "alwaysAllow": ["search_engine", "scrape_as_markdown"],在保证安全的同时降低打扰。
  • 本地开发选择 STDIO(更快),远程环境选择 SSE(更稳)。
  • 注意资源占用。本地运行 MCP 意味着你的机器在承担计算。如果你在大规模抓取时感觉变慢,可以切换到 Bright Data 托管的 MCP 服务,将计算卸载到云端。

别忘了保持 Kilo Code 扩展MCP 包为最新——开发者会频繁发布改进与修复,能显著提升稳定性。

总结

将 Kilo Code 与 Bright Data 的 Web MCP 连接起来,让你的编码助手在 VS Code 内即可访问实时网页数据。此设置帮助你使用最新信息,更好地完成编码与问题求解。

Bright Data 还提供强大的代理服务开箱即用的数据集,以及多种AI 相关解决方案。探索 Bright Data 的完整方案,找到最契合你工作流的工具。

立即开始,进一步拓展你的网页数据能力。

支持支付宝等多种支付方式