☰
Brave Search MCP MCP 服务说明文档
2026/9/30 7:07:52 网站建设 项目流程

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密钥应妥善保管,不要提交到版本控制系统

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询