Brave Search MCP 服务说明文档

1. 服务概述一句话简介集成Brave Search API的MCP服务器提供网页搜索和本地搜索功能服务名称Brave Search MCP Server版本号latest开发者/提供方PhamQuangVinh22022648协议类型MCP (Model Context Protocol)2. 核心功能列出该MCP服务提供的主要功能点网页搜索Web Search支持通用查询、新闻、文章搜索提供分页和新鲜度控制功能本地搜索Local Search查找商家、餐厅和服务提供详细的本地信息灵活过滤控制结果类型、安全级别和内容新鲜度智能回退本地搜索无结果时自动回退到网页搜索3. 使用场景描述该服务适合在什么情况下使用需要在AI助手中集成搜索功能获取实时网络信息查找本地商家、餐厅和服务信息获取详细的位置和联系方式获取最新的新闻、文章和资讯内容进行带过滤条件的精准搜索控制结果类型和内容新鲜度构建需要搜索能力的智能应用和对话系统4. 接入方式4.1 服务端点该MCP服务通过标准输入输出stdio进行通信支持以下两种运行方式Docker方式使用Docker容器运行镜像名称为mcp/brave-searchNPX方式使用Node.js的NPX工具运行包名为modelcontextprotocol/server-brave-search4.2 认证与权限API密钥要求使用该服务需要Brave Search API密钥获取API密钥步骤注册Brave Search API账户选择套餐免费套餐每月提供2,000次查询从开发者控制台生成API密钥4.3 数据格式服务使用JSON格式进行数据交换所有请求和响应均遵循MCP协议规范。4.4 服务器配置在MCP客户端配置中添加服务Docker配置示例{ mcpServers: { brave-search: { command: docker, args: [ run, -i, --rm, -e, BRAVE_API_KEY, mcp/brave-search ], env: { BRAVE_API_KEY: YOUR_API_KEY_HERE } } } }NPX配置示例{ mcpServers: { brave-search: { command: npx, args: [ -y, modelcontextprotocol/server-brave-search ], env: { BRAVE_API_KEY: YOUR_API_KEY_HERE } } } }VS Code配置示例在VS Code的用户设置JSON或工作区的.vscode/mcp.json文件中添加{ mcp: { inputs: [ { type: promptString, id: brave_api_key, description: Brave Search API Key, password: true } ], servers: { brave-search: { command: npx, args: [-y, modelcontextprotocol/server-brave-search], env: { BRAVE_API_KEY: ${input:brave_api_key} } } } } }5. 接口定义该MCP服务提供以下两个核心工具5.1 brave_web_search执行网页搜索支持分页和过滤功能。参数名类型必填说明querystring是搜索关键词countnumber否每页结果数最大20offsetnumber否分页偏移量最大95.2 brave_local_search搜索本地商家和服务无结果时自动回退到网页搜索。参数名类型必填说明querystring是本地搜索关键词countnumber否结果数量最大206. 快速开始6.1 环境要求方式一Docker已安装Docker环境方式二NPX已安装Node.js建议v14及以上版本必需有效的Brave Search API密钥6.2 示例代码以下是在Claude Desktop中使用该MCP服务的配置示例步骤1获取API密钥访问 Brave Search API 注册并获取API密钥。步骤2配置Claude Desktop编辑claude_desktop_config.json文件添加上述服务器配置。步骤3重启Claude Desktop重启应用后即可在对话中使用搜索功能。使用示例配置完成后您可以在Claude中使用如下提示词用户帮我搜索最近的意大利餐厅 Claude[调用 brave_local_search 工具] 用户搜索关于人工智能的最新新闻 Claude[调用 brave_web_search 工具]7. 注意事项API配额限制免费套餐每月提供2,000次查询如需更多请升级付费套餐API密钥安全请妥善保管API密钥不要将其提交到公开的代码仓库搜索结果限制网页搜索每次最多返回20条结果分页偏移量最大为9本地搜索回退当本地搜索无结果时系统会自动回退到网页搜索许可证该MCP服务采用MIT许可证可自由使用、修改和分发Docker构建如需自行构建Docker镜像可使用命令docker build -t mcp/brave-search:latest -f src/brave-search/Dockerfile .