AI导哈

Brave搜索MCP扩展

一个VS Code扩展，集成Brave Search API与模型上下文协议（MCP），使AI Copilot能够进行互联网搜索以用于研究和规划目的。

  • by overtonlabs
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Steve0verton/brave-search-vscode-mcp-extension

使用说明

勇敢地搜索MCP以获取VS代码

一个VS Code扩展，集成了 勇敢搜索API 通过模型上下文协议（MCP），使AI Copilot能够出于研究和规划目的进行互联网搜索。

特性

此扩展为AI Copilot提供了以下功能：

  • 🔍 网络搜索：使用Brave的独立搜索索引搜索网络
  • 📰 新闻搜索：查找最近的新闻文章和时事
  • 🖼️ 图像搜索：在网络上搜索图像
  • 🎬 视频搜索：搜索包含元数据和缩略图的视频
  • 📍 本地搜索：查找具有评级和小时数的本地企业和地点（需要搜索计划）

在代理模式下运行时，GitHub Copilot和VS Code中的其他AI助手可以自动使用这些功能。

先决条件

  • VS代码版本1.95.0或更高
  • 勇敢的搜索API密钥（提供免费层）
  • 已安装Node.js（运行MCP服务器所需）

安装

从VSIX文件（本地安装）

  1. 下载或构建 .vsix 文件
  2. 打开VS代码
  3. 转到“扩展”视图（Ctrl+Shift+X/Cmd+Shift+X）
  4. 单击“扩展”视图顶部的“…”菜单
  5. 选择“从VSIX安装…”
  6. 选择已下载的 .vsix 文件

来自VS代码市场

在扩展视图中搜索“Brave Search MCP”，然后单击安装。

获取勇敢的搜索API密钥

  1. 访问 勇敢搜索API
  2. 注册一个免费帐户
  3. 在仪表板中创建新的API键
  4. 复制API密钥（以开头 BSA)

API计划

  • 搜索：5美元/1000个请求-包括每月5美元的免费积分（自动申请）
  • 答案：4/1000美元查询+令牌成本——人工智能生成的可靠答案
  • 企业：自定义条款、容量和零数据保留-- 联系Brave

看 勇敢搜索API定价 了解全部细节。

配置

您的API密钥通过VS Code的安全存储在操作系统的密钥链中 秘密存储-从不在明文设置中，也从不通过设置同步进行同步。

初始设置

人工智能助手第一次使用勇敢搜索时，系统将提示您输入API密钥 并且它将被安全地保存。要提前设置，请使用命令选项板：

  1. 打开命令面板（Ctrl+Shift+P/Cmd+Shift+P）
  2. 键入“勇敢搜索MCP:配置API密钥”
  3. 提示时输入API密钥

管理您的密钥

这两个命令都在 勇敢搜索MCP 命令选项板中的类别：

  • 勇敢搜索MCP：配置API密钥 --设置密钥，或替换现有密钥（密钥旋转）
  • 勇敢搜索MCP：清除API密钥 --从安全存储中删除存储的密钥

从早期版本升级？ 如果您之前将密钥存储在 braveSearchMcp.apiKey 设置后，它会自动迁移到安全存储中 明文设置已清除，无需任何操作。

设置

  • braveSearchMcp.enabled：启用/禁用MCP服务器（默认值：true）
  • braveSearchMcp.apiKey: 已弃用 --仅保留用于将旧的明文密钥迁移到安全存储中。请改用“配置API密钥”命令。

用法

配置后，Brave搜索工具将自动提供给VS Code中的AI助手：

快速开始

  1. 打开Copilot聊天 -点击侧边栏中的聊天图标或使用Ctrl+Shift+I（Mac上的Cmd+Shift+I）
  2. 启用代理模式 -点击闪耀图标(✨) 在聊天输入框中
  3. 提出需要网络搜索的问题 -使用自然语言提示（见下面的示例）

当您的问题需要来自互联网的最新信息时，人工智能将自动使用Brave Search。

示例提示

试着问副驾驶这样的问题：

🔍 Web搜索示例

  • TypeScript 5.7的最新特性是什么
  • “查找vscode.lm API的文档”
  • “搜索React服务器组件的最佳实践”
  • “查找Python async/await的当前语法”
  • “查找使用Fetch API进行错误处理的示例”
  • “REST和GraphQL有什么区别？”

📰 新闻搜索示例

  • “查找有关AI编码助手的最新消息”
  • “Microsoft Build的最新公告是什么？”
  • “搜索有关最新VS Code更新的新闻”
  • “查找有关GitHub Copilot功能的最新文章”
  • “本月JavaScript生态系统有什么新变化？”

🖼️ 图像搜索示例

  • “查找VS Code徽标的图像”
  • “搜索TypeScript架构图”
  • “查找流行的VS Code主题的屏幕截图”
  • “查找代表API概念的图标”

🎬 视频搜索示例

  • “查找Rust入门教程视频”
  • “搜索关于分布式系统的会议讨论”
  • “查找解释变压器如何在机器学习中工作的视频”
  • “查找VS Code提示和技巧视频”

📍 本地搜索示例

  • “查找西雅图市中心附近的咖啡店”
  • “在德克萨斯州奥斯汀寻找共享办公空间”
  • “在芝加哥找到评价很高的泰国餐厅”
  • “找我附近开的五金店”

💡 最佳结果提示：

  • 使用自然语言 -无需特殊语法或命令
  • 要具体 -你的问题越具体，结果就越好
  • 让AI来决定 -Copilot自动选择要使用的搜索工具
  • 需要代理模式 -确保闪闪发光的图标(✨) 正在聊天

运作原理

此扩展使用 模型上下文协议（MCP） 将人工智能助手连接到勇敢搜索API：

  1. 扩展使用VS代码注册MCP服务器定义
  2. 激活后，它将启动官方 @brave/brave-search-mcp-server 包裹
  3. MCP服务器向AI助手公开搜索工具
  4. AI助手可以根据用户意图自动调用这些工具
  5. 搜索结果被返回并合并到AI响应中

故障排除

“API密钥未配置”警告

  • 从命令面板运行“勇敢搜索MCP:配置API密钥”以（重新）输入密钥
  • 验证API密钥是否正确，并从 BSA

Copilot中未显示搜索工具

  • 确保您使用的是VS Code 1.95.0或更高版本
  • 确保Copilot处于代理模式（闪烁图标）
  • 检查 braveSearchMcp.enabled 设置为 true
  • 配置API密钥后重新启动VS代码

“找不到npx命令”错误

  • 确保你的系统上安装了Node.js和npm
  • 安装Node.js后重新启动VS代码
  • 验证npm是否在您的系统PATH中

速率限制错误

  • 在中检查您的API使用情况 勇敢的API仪表板
  • 搜索计划包括每月5美元的免费积分，超过此金额的使用将按每1000次请求收取5美元的费用

隐私和安全

  • 您的API密钥通过VS Code Secret Storage安全存储在您的操作系统密钥链中-不以明文设置存储，也不由设置同步携带
  • API密钥从未传输到Brave的API服务器
  • 搜索查询由Brave Search处理（请参见 Brave隐私政策)
  • 该扩展仅在人工智能助手请求MCP服务器时激活

从源头构建

# Clone the repository
git clone https://github.com/overtonlabs/brave-search-vscode-mcp-extension.git
cd brave-search-vscode-mcp-extension

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Package the extension
npm run package

# This creates a .vsix file you can install

发展

# Watch mode for development
npm run watch

# Run in Extension Development Host
# Press F5 in VS Code to launch a new window with the extension loaded

功能请求和贡献

有想法或发现bug？ 在GitHub上打开一个问题 --所有功能请求和增强想法都在那里被跟踪。

欢迎投稿！请随时提交问题或拉取请求。

许可证

BSD 3条款许可证-有关详细信息，请参阅许可证文件

链接

致谢

备注：此扩展需要活动的互联网连接和有效的Brave Search API密钥才能运行。

相关 MCP