关键词

网络搜索本地搜索Brave Search APIAI 助手工具集成

使用说明

项目简介

Brave Search MCP Server 是一个 MCP (Model Context Protocol) 服务器，旨在为 AI 助手（如 Claude）提供便捷的 Brave Search 搜索功能。通过该服务器，AI 助手可以调用预设的工具，利用 Brave Search API 进行网络搜索和本地搜索，从而增强其信息获取和处理能力。

主要功能点

  • 网络搜索工具 (brave_web_search): 使用 Brave Search API 执行网络搜索，返回格式化的搜索结果，帮助 AI 助手快速获取互联网信息。
  • 本地搜索工具 (brave_local_search): 利用 Brave Search API 搜索本地商家和地点信息，为 AI 助手提供本地化的信息查询能力。
  • 速率限制: 内置简单的速率限制机制，防止 API 调用过频。
  • 易于安装和配置: 提供通过 Smithery 自动安装和手动安装两种方式，配置简单明了。

安装步骤

通过 Smithery 自动安装 (推荐 Claude Desktop 用户):

如果您使用 Claude Desktop 等支持 Smithery 的 MCP 客户端，可以使用以下命令一键安装：

npx -y @smithery/cli install @arben-adm/brave-mcp-search --client claude

手动安装:

  1. 克隆仓库:

    git clone https://github.com/arben-adm/brave-mcp-search.git
cd brave-mcp-search

  2. 创建虚拟环境并安装依赖:

    uv venv
source .venv/bin/activate   # Linux/macOS
# .venv\Scripts\activate  # Windows
uv pip install -r requirements.txt

    确保您已安装 Python 3.11+ 和 uv。

  3. 设置 Brave Search API 密钥: 获取 Brave Search API 密钥并将其设置为环境变量 'BRAVE_API_KEY'。

    • Linux/macOS: 
      export BRAVE_API_KEY=your_api_key_here
    • Windows (PowerShell): 
      $env:BRAVE_API_KEY = "your_api_key_here"
      或者 (CMD): 
      set BRAVE_API_KEY=your_api_key_here
      请将 'your_api_key_here' 替换为您的实际 API 密钥。

服务器配置

要将 Brave Search MCP Server 集成到 MCP 客户端，您需要在客户端的 MCP 配置文件中添加服务器配置信息。以下是一个 Claude Desktop 客户端的配置示例，您可以参考进行配置：

{
  "mcpServers": {
    "brave-search": {
      "command": "uv",
      "args": [
        "--directory",
        "path-to\\brave-mcp-search\\src",  // 将 "path-to\\brave-mcp-search" 替换为您的 brave-mcp-search 仓库的实际路径
        "run",
        "server.py"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE" // 确保此处也替换为您的 Brave API 密钥，或者删除此行，服务器将从系统环境变量中读取
      }
    }
  }
}

配置参数说明:

  • '"brave-search"': 服务器名称，客户端用此名称引用该服务器。
  • '"command": "uv"': 启动服务器的命令，这里使用 'uv' 运行 Python 脚本。
  • '"args"': 传递给 'uv run' 命令的参数列表。
    • '"--directory", "path-to\brave-mcp-search\src"': 指定 Python 脚本的搜索目录为 'src' 文件夹，请替换为实际路径。
    • '"run", "server.py"': 使用 'uv run' 运行 'src' 目录下的 'server.py' 脚本。
  • '"env"': 设置服务器运行时的环境变量。
    • '"BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE"': 设置 Brave API 密钥，请务必替换为您的实际密钥，或者为了安全考虑，推荐从系统环境变量中读取，此时可以删除此行。

注意: 'path-to\brave-mcp-search' 需要替换为您本地 brave-mcp-search 仓库的实际路径。请根据您的 MCP 客户端的具体配置方法进行配置。

基本使用方法

  1. 确保 Brave Search MCP Server 已正确安装、配置并启动。
  2. 在您的 MCP 客户端（如 Claude），您应该能够看到 'brave_web_search' 和 'brave_local_search' 这两个工具。
  3. 在与 AI 助手对话时，您可以指示 AI 助手使用这些工具进行搜索。例如，您可以提问：
    • "使用网络搜索查找最新的科技新闻。" (AI 助手可能会调用 'brave_web_search' 工具)
    • "帮我搜索附近的咖啡馆。" (AI 助手可能会调用 'brave_local_search' 工具)
  4. AI 助手调用工具后，服务器会执行相应的搜索操作，并将结果返回给 AI 助手，最终由 AI 助手将结果呈现给您。

请参考您的 MCP 客户端的文档，了解如何更详细地使用和控制 MCP 服务器及其提供的工具。

信息

分类

网页与API

访问项目