FindMCP Logo FindMCP.info
Brave Search MCP/SSE Server

Brave Search MCP/SSE Server

site icon
2025.04.01 7
TypeScript搜索服务API 集成实时流式传输搜索工具
Brave Search MCP/SSE Server 是一个基于 Model Context Protocol (MCP) 和 Server-Sent Events (SSE) 的实现，集成了 Brave Search API，为 AI 模型和其他客户端提供通过流式接口访问网络和本地搜索的能力。该服务器旨在为理解 MCP 的大型语言模型提供工具支持，通过 SSE 连接实时流式传输搜索结果和状态更新。
View on GitHub

Overview

基本能力

产品定位

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 访问。
  • 需要实时流式搜索结果的应用程序。

工具列表

  1. brave_web_search
  2. 描述：使用 Brave Search API 执行一般网络搜索。
  3. 输入：查询字符串、结果数量、分页偏移等。

  4. 输出：流式传输包含搜索结果的 MCP 消息。

  5. brave_local_search

  6. 描述：使用 Brave Search API 执行本地商家和地点搜索。
  7. 输入：查询字符串、结果数量等。
  8. 输出：流式传输包含本地商家详细信息的 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 (推荐)

  1. 获取 Brave Search API Key。
  2. 拉取 Docker 镜像： bash docker pull shoofio/brave-search-mcp-sse:latest
  3. 运行 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 部署)

  1. 获取 Brave Search API Key。
  2. 添加 Helm 仓库： bash helm repo add brave-search-mcp-sse https://shoofio.github.io/brave-search-mcp-sse/ helm repo update
  3. 创建 Kubernetes secret： bash kubectl create secret generic brave-search-secret --from-literal=api-key='YOUR_API_KEY_HERE' -n <your-namespace>
  4. 安装 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: 本地开发

  1. 获取 Brave Search API Key。
  2. 克隆仓库： bash git clone <repository_url> cd brave-search-mcp-sse
  3. 安装依赖： bash npm install
  4. 设置环境变量： env BRAVE_API_KEY=YOUR_API_KEY_HERE PORT=8080
  5. 构建代码： bash npm run build
  6. 运行服务器： bash npm start

调试方式

  • 使用 curl 测试 SSE 连接： bash curl -N http://localhost:8080/
  • 检查日志： bash docker logs brave-search-server

许可证

该项目遵循 MIT 开源许可条款。