1. 服务概述
一句话简介:利用Brave Search API进行网页和本地搜索的MCP服务器,支持可选的HTTP代理配置。
- 服务名称:Brave Search MCP
- 版本号:最新版本
- 开发者/提供方:kwp-lab
- 协议类型:MCP (Model Context Protocol)
2. 核心功能
列出该MCP服务提供的主要功能点:
- 网页搜索:执行一般查询、新闻、文章,支持分页和新颖性控制
- 本地搜索:查找商家、餐厅和服务,提供详细信息
- 灵活过滤:控制结果类型、安全级别和内容新颖性
- 智能回退:本地搜索在未找到结果时自动回退到网页搜索
- 代理支持:通过HTTP或HTTPS代理路由请求,增强隐私或绕过限制
- 身份验证:需要Brave Search API密钥
3. 使用场景
描述该服务适合在什么情况下使用:
- 网页搜索:搜索新闻、文章和在线内容
- 本地商家搜索:查找附近的商家、餐厅和服务
- 内容研究:研究特定主题的网页内容
- 隐私保护:通过代理服务器路由搜索请求
- 绕过限制:绕过地理位置限制或访问限制
- API集成:将Brave Search API集成到AI助手工作流中
4. 接入方式
4.1 服务端点
Brave Search MCP Server作为MCP服务器运行,通过标准输入输出进行通信。服务器使用Node.js运行,支持Docker和NPX两种部署方式。
4.2 认证与权限
服务器需要Brave Search API密钥进行身份验证:
- API密钥获取:注册Brave Search API账户,选择计划(免费层每月2,000次查询),从开发者仪表板生成API密钥
- 代理配置:可选配置HTTP或HTTPS代理服务器
4.3 数据格式
服务器使用JSON格式进行数据交换:
- 输入:JSON格式的参数对象,包含搜索查询和可选参数
- 输出:搜索结果列表,包括标题、URL、描述等信息
4.4 服务器配置
在Claude Desktop配置中添加服务(NPX方式):
{ "mcpServers": { "brave-search": { "command": "npx", "args": [ "-y", "@kwp-lab/mcp-brave-search" ], "env": { "BRAVE_API_KEY": "YOUR_API_KEY_HERE", "BRAVE_SEARCH_PROXY": "https://example.com:10890" } } } }5. 接口定义
| 工具名称 | 描述 | 参数 |
|---|---|---|
| brave_web_search | 执行网页搜索,支持分页和过滤 | query(必需), count(可选,最大20), offset(可选,最大9) |
| brave_local_search | 搜索本地商家和服务 | query(必需), count(可选,最大20) |
6. 快速开始
6.1 环境要求
- Node.js环境
- npm包管理器
- Brave Search API密钥
- 可选:代理服务器
6.2 示例代码
网页搜索:
brave_web_search({ "query": "latest technology news", "count": 10, "offset": 0 })本地搜索:
brave_local_search({ "query": "coffee shops near me", "count": 10 })7. 注意事项
- API密钥:需要Brave Search API密钥,免费层每月提供2,000次查询
- 代理配置:服务器会自动使用
http_proxy和https_proxy环境变量,或通过BRAVE_SEARCH_PROXY环境变量配置专用代理 - 智能回退:本地搜索在未找到结果时会自动回退到网页搜索
- 结果限制:每次搜索最多返回20个结果,分页偏移最大为9
- 许可证:MIT许可证,可自由使用、修改和分发
- 部署方式:支持Docker和NPX两种部署方式,NPX方式无需安装
- VS Code集成:支持VS Code的一键安装和手动配置
- 安全性:API密钥应妥善保管,不要提交到版本控制系统