基本能力
产品定位
Brave Search MCP/SSE Server 是一个中间件服务，旨在为 AI 模型和客户端提供对 Brave Search API 的集中访问，支持实时流式搜索功能。
核心功能
- 网络搜索：访问 Brave 的独立网络搜索索引，支持分页和过滤控制。
- 本地搜索：查找本地商家、餐厅和服务，提供详细地址、电话号码和评分等信息。
- 智能回退：如果本地搜索没有结果，自动回退到过滤后的网络搜索。
- Server-Sent Events (SSE)：实时流式传输搜索结果和工具执行状态。
- Model Context Protocol (MCP)：符合 MCP 标准，便于与兼容客户端集成。
- Docker 支持：包含 Dockerfile，便于容器化部署。
- Helm Chart：提供 Helm chart，便于在 Kubernetes 集群中部署。
适用场景
- 为 AI 模型提供实时搜索功能。
- 企业内部集中管理 Brave Search API 访问。
- 需要实时流式搜索结果的应用程序。
工具列表
brave_web_search- 描述：使用 Brave Search API 执行一般网络搜索。
- 输入：查询字符串、结果数量、分页偏移等。
-
输出：流式传输包含搜索结果的 MCP 消息。
-
brave_local_search - 描述：使用 Brave Search API 执行本地商家和地点搜索。
- 输入：查询字符串、结果数量等。
- 输出：流式传输包含本地商家详细信息的 MCP 消息。
常见问题解答
- 如何获取 Brave Search API Key：需要注册 Brave Search API 账户并生成 API 密钥。
- 如何配置服务器：通过环境变量
BRAVE_API_KEY设置 API 密钥，并可配置端口和日志级别。
使用教程
使用依赖
- Brave Search API Key：必需。
- Docker：如果使用 Docker 部署。
- kubectl & Helm：如果使用 Kubernetes 部署。
- Node.js & npm：仅本地开发需要。
- Git：克隆仓库需要。
安装教程
选项 1: Docker (推荐)
- 获取 Brave Search API Key。
- 拉取 Docker 镜像：
bash
docker pull shoofio/brave-search-mcp-sse:latest - 运行 Docker 容器：
bash
docker run -d --rm -p 8080:8080 -e BRAVE_API_KEY="YOUR_API_KEY_HERE" --name brave-search-server shoofio/brave-search-mcp-sse:latest
选项 2: Helm (Kubernetes 部署)
- 获取 Brave Search API Key。
- 添加 Helm 仓库：
bash
helm repo add brave-search-mcp-sse https://shoofio.github.io/brave-search-mcp-sse/
helm repo update - 创建 Kubernetes secret：
bash
kubectl create secret generic brave-search-secret --from-literal=api-key='YOUR_API_KEY_HERE' -n <your-namespace> - 安装 Helm chart：
bash
helm install brave-search brave-search-mcp-sse/brave-search-mcp-sse -n <your-namespace> --set braveSearch.existingSecret=brave-search-secret
选项 3: 本地开发
- 获取 Brave Search API Key。
- 克隆仓库：
bash
git clone <repository_url>
cd brave-search-mcp-sse - 安装依赖：
bash
npm install - 设置环境变量：
env
BRAVE_API_KEY=YOUR_API_KEY_HERE
PORT=8080 - 构建代码：
bash
npm run build - 运行服务器：
bash
npm start
调试方式
- 使用
curl测试 SSE 连接：
bash
curl -N http://localhost:8080/ - 检查日志：
bash
docker logs brave-search-server
