使用说明

项目简介

Brave Search MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它集成了 Brave Search API，提供了网页搜索和本地搜索两种工具。该服务器旨在为大型语言模型 (LLM) 应用提供联网搜索能力，帮助 LLM 获取最新的信息和本地商业信息，从而提升 LLM 在信息检索和本地服务查询方面的能力。

主要功能点

网页搜索 (brave_web_search)： 使用 Brave Search API 执行网页搜索，适用于广泛的信息查询、新闻、文章和在线内容检索。支持分页和结果数量控制。
本地搜索 (brave_local_search)： 使用 Brave Local Search API 搜索本地商业和服务场所，适用于查询物理位置、商家、餐馆等信息。返回详细的商家信息，包括名称、地址、评分、电话和营业时间等。
速率限制： 服务器内置速率限制，以符合 Brave Search API 的使用条款。
标准 MCP 协议： 通过 Stdio 传输协议和 JSON-RPC 协议与 MCP 客户端通信，易于集成到各种 LLM 应用中。

安装步骤

克隆仓库

git clone https://github.com/jmagar/mcp-servers.git
cd mcp-servers

进入 brave-search 目录
```
cd brave-search
```
安装依赖
```
npm install
```
配置 Brave Search API 密钥
- 你需要拥有 Brave Search API 的密钥才能使用此服务器。
- 设置名为 'BRAVE_API_KEY' 的环境变量，并将你的 API 密钥设置为该变量的值。

服务器配置

MCP 客户端需要配置以下 JSON 信息才能连接到 Brave Search MCP Server：

{
  "server name": "brave-search",
  "command": "brave-search/index.js",
  "args": []
}

server name: 服务器的名称，设置为 "brave-search" 以标识该服务器。
command: 启动服务器的命令，指向 'brave-search' 目录下的 'index.js' 文件。这假设你的工作目录是 'mcp-servers' 仓库的根目录。
args: 启动命令的参数，此服务器不需要额外的启动参数，因此设置为空数组 '[]'。

注意: 确保在运行 MCP 客户端之前，'BRAVE_API_KEY' 环境变量已经正确设置。

基本使用方法

启动服务器： 在 'mcp-servers/brave-search' 目录下，运行 'npm start' 命令启动服务器。服务器将通过 stdio 准备就绪，等待 MCP 客户端的请求。

MCP 客户端请求： MCP 客户端可以使用 'brave_web_search' 或 'brave_local_search' 工具进行搜索。

调用 'brave_web_search' 工具的示例请求参数：

{
  "name": "brave_web_search",
  "arguments": {
    "query": "最新的科技新闻",
    "count": 5
  }
}

调用 'brave_local_search' 工具的示例请求参数：

{
  "name": "brave_local_search",
  "arguments": {
    "query": "附近的咖啡馆",
    "count": 3
  }
}

服务器将返回包含搜索结果的 JSON-RPC 响应。

关键词