搜索服务API

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

  • by keith-johnson963
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 keith-johnson963/mcp-web-search

使用说明

Brave Search MCP服务器

集成了以下功能的MCP服务器实现 勇敢搜索API,提供网络搜索、本地兴趣点搜索、视频搜索、图像搜索和新闻搜索功能

特性

  • 网页搜索:定期在网上搜索
  • 图像搜索:在网上搜索图片。图像搜索结果将作为资源提供
  • 新闻搜索:在网上搜索新闻
  • 视频搜索:在网上搜索视频
  • 本地兴趣点搜索:搜索当地的物理位置、企业、餐馆、服务等

工具

  • 勇敢的网络搜索

    • 使用Brave的API执行网络搜索
    • 输入:
      • query (string):在互联网上搜索的术语
      • count (number,可选):要返回的结果数(最大20,默认10)
      • offset (number,可选,默认为0):分页偏移量
      • freshness (enum,可选):根据搜索结果的发现时间进行筛选
        • 支持以下值
          • pd:在过去24小时内发现。
          • pw:在过去7天内发现。
          • 下午:在过去31天内发现。
          • py:在过去365天内发现
          • YYYY MM DD到YYYY MM DD:自定义日期范围(例如,2022-04-01到2022-07-30)
  • 勇敢图片搜索

    • 从网络上获取与查询相关的图像
    • 输入:
      • query (string):在互联网上搜索以下图片的术语
      • count (number,可选):要返回的图像数量(最多3个,默认1个)
  • 勇敢_新闻_搜索

    • 在网上搜索新闻
    • 输入:
      • query (string):在互联网上搜索新闻文章、热门话题或最近事件的术语
      • count (number,可选):要返回的结果数(最大20,默认10)
      • freshness (enum,可选):根据搜索结果的发现时间进行筛选
        • 支持以下值
          • pd:在过去24小时内发现。
          • pw:在过去7天内发现。
          • 下午:在过去31天内发现。
          • py:在过去365天内发现
          • YYYY MM DD到YYYY MM DD:自定义日期范围(例如,2022-04-01到2022-07-30)
  • 勇敢的探索

    • 搜索当地企业、服务和兴趣点
    • 需要 订阅Pro-api计划以获取位置结果
    • 如果找不到位置结果,则返回brave_web_search
    • 输入:
      • query (string):本地搜索词
      • count (number,可选):要返回的结果数(最大20,默认5)
  • 勇敢_视频_搜索

    • 在网上搜索视频
    • 输入:
      • query:(string):用于搜索视频的术语
      • count:(数字,可选):要返回的视频数量(最多20个,默认10个)
      • freshness (enum,可选):根据搜索结果的发现时间进行筛选
        • 支持以下值
          • pd:在过去24小时内发现。
          • pw:在过去7天内发现。
          • 下午:在过去31天内发现。
          • py:在过去365天内发现
          • YYYY MM DD到YYYY MM DD:自定义日期范围(例如,2022-04-01到2022-07-30)

配置

获取API密钥

  1. 注册一个 勇敢搜索API帐户
  2. 选择一个计划(免费套餐每月可查询2000次)
  3. 生成API密钥 从开发人员仪表板

使用Claude代码

对于 克劳德代码 用户,运行以下命令:

窗户:

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)

  1. 下载 dxt 文件来自 发布
  2. 使用Claude Desktop打开它 或 转到“文件”->“设置”->“扩展名”,然后拖动。DXT文件到窗口进行安装

码头工人

  1. 克隆仓库
  2. Docker构建
docker build -t brave-search-mcp:latest -f ./Dockerfile .
  1. 将此添加到您的 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

贡献

欢迎投稿!请随时提交拉取请求。

桌面扩展(DXT)

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

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

npm install -g @anthropic-ai/dxt

创建manifest.json文件

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

创建 dxt 文件

  1. 首先安装开发依赖项并构建
npm install
npm run build
  1. 然后只安装生产依赖项,生成一个较小的nodule_modules目录
npm install --omit=dev
  1. 跑 dxt pack 创建a dxt 文件。这也将验证创建的manifest.json。这 dxt 本质上是一个zip文件,将包含此目录中的所有内容。

免责声明

此库与Brave Software没有正式关联。它是Brave Search API的第三方实现,带有MCP服务器。

许可证

此项目根据GNU通用公共许可证v3.0获得许可-请参阅 许可证 文件以获取详细信息。