勇敢搜索-MCP

Name: 勇敢搜索-MCP
Author: mikechao

作者：mikechao87 星标更新：2025-07-30

安装使用来源：spider==github.com

项目介绍

Brave Search MCP Server

集成Brave Search API的MCP服务器实现，提供网页搜索、本地兴趣点搜索、视频搜索、图片搜索和新闻搜索功能。

功能

网页搜索：执行常规的网络搜索。
图片搜索：在互联网上搜索图片。图片搜索结果将以资源的形式提供。
新闻搜索：在互联网上搜索新闻。
视频搜索：在互联网上搜索视频。
本地兴趣点搜索：搜索本地物理位置、企业、餐馆、服务等。

工具

brave_web_search
- 使用Brave的API执行网络搜索。
- 输入参数：
  - query (字符串)：要搜索的关键词。
  - count (数字，可选)：返回的结果数量（最大20，默认10）。
  - offset (数字，可选，默认0)：分页偏移量。
  - freshness (枚举，可选)：根据发现时间过滤搜索结果。
    - 支持以下值：
      - pd: 发现于最近24小时内。
      - pw: 发现于最近7天内。
      - pm: 发现于最近31天内。
      - py: 发现于最近365天内。
      - YYYY-MM-DDtoYYYY-MM-DD: 自定义日期范围（例如，2022-04-01to2022-07-30）。
brave_image_search
- 获取与查询相关的网络图片。
- 输入参数：
  - query (字符串)：要搜索的图片关键词。
  - count (数字，可选)：返回的图片数量（最大3，默认1）。
brave_news_search
- 在互联网上搜索新闻文章、热门话题或近期事件。
- 输入参数：
  - query (字符串)：要搜索的新闻关键词。
  - count (数字，可选)：返回的结果数量（最大20，默认10）。
  - freshness (枚举，可选)：根据发现时间过滤搜索结果。
    - 支持以下值：
      - pd: 发现于最近24小时内。
      - pw: 发现于最近7天内。
      - pm: 发现于最近31天内。
      - py: 发现于最近365天内。
      - YYYY-MM-DDtoYYYY-MM-DD: 自定义日期范围（例如，2022-04-01to2022-07-30）。
brave_local_search
- 搜索本地企业、服务和兴趣点。
- 需要订阅Pro API计划以获取位置结果。
- 如果没有找到位置结果，则回退到brave_web_search。
- 输入参数：
  - query (字符串)：本地搜索关键词。
  - count (数字，可选)：返回的结果数量（最大20，默认5）。
brave_video_search
- 在互联网上搜索视频。
- 输入参数：
  - query (字符串)：要搜索的视频关键词。
  - count (数字，可选)：返回的视频数量（最大20，默认10）。
  - freshness (枚举，可选)：根据发现时间过滤搜索结果。
    - 支持以下值：
      - pd: 发现于最近24小时内。
      - pw: 发现于最近7天内。
      - pm: 发现于最近31天内。
      - py: 发现于最近365天内。
      - YYYY-MM-DDtoYYYY-MM-DD: 自定义日期范围（例如，2022-04-01to2022-07-30）。

配置

获取API密钥

注册一个Brave Search API账户。
选择一个计划（免费层级每月提供2,000次查询）。
从开发者仪表板生成您的API密钥。

使用Claude Code

对于Claude Code用户，运行以下命令：

Windows:

claude mcp add-json brave-search '{"command":"cmd","args":["/c","npx","-y","brave-search-mcp"],"env":{"BRAVE_API_KEY":"YOUR_API_KEY_HERE"}}'

Linux/macOS:

claude mcp add-json brave-search '{"command":"npx","args":["-y","brave-search-mcp"],"env":{"BRAVE_API_KEY":"YOUR_API_KEY_HERE"}}'

将YOUR_API_KEY_HERE替换为您实际的Brave Search API密钥。

使用Claude Desktop

桌面扩展（DXT）

从发布页面下载dxt文件。
使用Claude Desktop打开它，或者前往文件 -> 设置 -> 扩展，并将.DXT文件拖放到窗口中进行安装。

Docker

克隆仓库。
构建Docker镜像。

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

将此内容添加到您的claude_desktop_config.json：

{
  "mcp-servers": {
    "brave-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRAVE_API_KEY",
        "brave-search-mcp"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR API KEY HERE"
      }
    }
  }
}

NPX

将此内容添加到您的claude_desktop_config.json：

{
  "mcp-servers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "brave-search-mcp"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR API KEY HERE"
      }
    }
  }
}

使用LibreChat

将此内容添加到librechat.yaml：

brave-search:
  command: sh
  args:
    - -c
    - BRAVE_API_KEY=API KEY npx -y brave-search-mcp

贡献

欢迎贡献！请随时提交Pull Request。

桌面扩展（DXT）

Anthropic最近发布了桌面扩展，允许一键安装本地MCP服务器。

安装CLI工具以帮助生成manifest.json和最终的.dxt文件。

npm install -g @anthropic-ai/dxt

创建manifest.json文件

在包含本地MCP服务器的文件夹/目录中，运行dxt init。该命令将启动一个交互式CLI来帮助创建manifest.json。

创建dxt文件

首先安装开发依赖并构建。

npm install
npm run build

然后仅安装生产依赖，生成更小的node_modules目录。

npm install --omit=dev

运行dxt pack以创建一个dxt文件。这也将验证创建的manifest.json。dxt本质上是一个zip文件，将包含此目录中的所有内容。

免责声明

本库未与Brave Software官方关联。这是一个第三方实现的Brave Search API的MCP服务器。

许可证

本项目基于GNU通用公共许可证v3.0发布 - 详情见LICENSE文件。