Brave搜索服务

Brave搜索服务是一个集成了Brave搜索API的MCP服务器实现,提供网页搜索和本地搜索功能。该服务支持灵活的过滤选项、智能回退机制,并能通过Docker或NPX快速部署。

  • by VinhPhamAI
  • 更新于
在 GitHub 查看 VinhPhamAI/brave-search

使用说明

基本能力

产品定位

Brave搜索服务是一个集成了Brave搜索API的MCP服务器,旨在提供高效、灵活的搜索解决方案。

核心功能

  • 网页搜索:支持通用查询、新闻、文章搜索,带有分页和新鲜度控制
  • 本地搜索:查找商家、餐厅和服务,提供详细信息
  • 灵活过滤:控制结果类型、安全级别和内容新鲜度
  • 智能回退:当本地搜索无结果时自动回退到网页搜索

适用场景

  • 需要集成搜索功能的应用程序
  • 需要本地商业信息查询的服务
  • 需要灵活控制搜索结果的项目

工具列表

  • brave_web_search

    • 执行带分页和过滤的网页搜索
    • 输入参数:
      • query:搜索关键词
      • count(可选):每页结果数(最多20)
      • offset(可选):分页偏移量(最多9)
  • brave_local_search

    • 搜索本地商家和服务
    • 输入参数:
      • query:本地搜索关键词
      • count(可选):结果数量(最多20)
    • 无本地结果时自动回退到网页搜索

使用教程

使用依赖

  1. 注册Brave搜索API账户
  2. 选择计划(免费层每月2000次查询)
  3. 从开发者仪表板生成API密钥

安装教程

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"
      }
    }
  }
}

调试方式

构建Docker镜像:

docker build -t mcp/brave-search:latest -f src/brave-search/Dockerfile .