勇敢地搜索MCP以获取VS代码
 ](https://code.visualstudio.com/) ](https://github.com/Steve0verton/brave-search-vscode-mcp-extension/issues)
一个VS Code扩展,集成了 勇敢搜索API 通过模型上下文协议(MCP),使AI Copilot能够出于研究和规划目的进行互联网搜索。
特性
此扩展为AI Copilot提供了以下功能:
- 🔍 网络搜索:使用Brave的独立搜索索引搜索网络
- 📰 新闻搜索:查找最近的新闻文章和时事
- 🖼️ 图片搜索:在网络上搜索图像
- 🎬 视频搜索:搜索包含元数据和缩略图的视频
- 📍 本地搜索:查找具有评级和小时数的本地企业和地点(需要搜索计划)
在代理模式下运行时,GitHub Copilot和VS Code中的其他AI助手可以自动使用这些功能。
先决条件
- VS代码版本1.95.0或更高
- 勇敢的搜索API密钥(提供免费层)
- 已安装Node.js(运行MCP服务器所需)
安装
从VSIX文件(本地安装)
- 下载或构建
.vsix文件 - 打开VS代码
- 转到“扩展”视图(Ctrl+Shift+X/Cmd+Shift+X)
- 单击“扩展”视图顶部的“…”菜单
- 选择“从VSIX安装…”
- 选择已下载的
.vsix文件
来自VS代码市场
在扩展视图中搜索“Brave Search MCP”,然后单击安装。
获取勇敢的搜索API密钥
- 访问 勇敢搜索API
- 注册一个免费帐户
- 在仪表板中创建新的API键
- 复制API密钥(以开头
BSA)
API计划
- 搜索:5美元/1000个请求-包括每月5美元的免费积分(自动申请)
- 答案:4/1000美元查询+令牌成本——人工智能生成的可靠答案
- 企业:自定义条款、容量和零数据保留-- 联系Brave
看 勇敢搜索API定价 了解全部细节。
配置
初始设置
安装扩展后,系统将提示您配置API密钥。您还可以:
- 打开VS代码设置(Ctrl+、/Cmd+、)
- 搜索“勇敢搜索MCP”
- 在中输入API密钥
Brave Search Mcp: Api Key领域
使用命令面板
- 打开命令面板(Ctrl+Shift+P/Cmd+Shift+P)
- 键入“勇敢搜索MCP:配置API密钥”
- 提示时输入API密钥
设置
braveSearchMcp.apiKey:您勇敢的搜索API密钥braveSearchMcp.enabled:启用/禁用MCP服务器(默认值:true)
用法
配置后,Brave搜索工具将自动提供给VS Code中的AI助手:
快速开始
- 打开Copilot聊天 -点击侧边栏中的聊天图标或使用Ctrl+Shift+I(Mac上的Cmd+Shift+I)
- 启用代理模式 -点击闪耀图标(✨) 在聊天输入框中
- 提出需要网络搜索的问题 -使用自然语言提示(见下面的示例)
当您的问题需要来自互联网的最新信息时,人工智能将自动使用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:
- 扩展使用VS代码注册MCP服务器定义
- 激活后,它将启动官方
@brave/brave-search-mcp-server包裹 - MCP服务器向AI助手公开搜索工具
- AI助手可以根据用户意图自动调用这些工具
- 搜索结果被返回并合并到AI响应中
故障排除
“API密钥未配置”警告
- 请确保在扩展设置中输入了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的设置中
- API密钥从未传输到Brave的API服务器
- 搜索查询由Brave Search处理(请参见 Brave隐私政策)
- 该扩展仅在人工智能助手请求MCP服务器时激活
从源头构建
# Clone the repository
git clone https://github.com/Steve0verton/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? --所有功能请求和增强想法都在那里被跟踪。
欢迎投稿!请随时提交问题或拉取请求。
许可证
BSD 3条款许可证-有关详细信息,请参阅许可证文件
链接
致谢
- 使用官方 @勇敢/勇敢搜索mcp服务器 包裹
- 由...驱动 勇敢搜索API
- 实施 模型上下文协议 标准
______________________________________________________________________
备注:此扩展需要活动的互联网连接和有效的Brave Search API密钥才能运行。
