Brave Search MCP Server

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

特性

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

工具

• brave_web_search

  • 使用 Brave 的 API 执行网页搜索
  • 输入：
    • query (字符串)：要在互联网上搜索的词条
    • count (数字, 可选)：要返回的结果数量（最大20，默认10）

• brave_image_search

  • 获取与查询相关的网络图片
  • 输入：
    • query (字符串)：要在互联网上搜索图片的词条
    • count (数字, 可选)：要返回的图片数量（最大3，默认1）

• brave_news_search

  • 在互联网上搜索新闻
  • 输入：
    • query (字符串)：要在互联网上搜索的新闻文章、热门话题或最近事件
    • count (数字, 可选)：要返回的结果数量（最大20，默认10）

• brave_local_search

  • 搜索本地商家、服务和兴趣点
  • 需要 订阅 Pro API 计划以获取位置结果
  • 如果没有找到位置结果，则回退到 brave_web_search
  • 输入：
    • query (字符串)：本地搜索词条
    • count (数字, 可选)：要返回的结果数量（最大20，默认5）

• brave_video_search

  • 在互联网上搜索视频
  • 输入：
    • query (字符串)：要搜索的视频词条
    • count (数字, 可选)：要返回的视频数量（最大20，默认10）

配置

获取 API 密钥

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

与 Claude Desktop 一起使用

将以下内容添加到您的 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。

调试

1. 克隆仓库

2. 安装依赖项并构建它

npm install

1. 构建应用

npm run build

使用 VS Code 运行和调试功能

⚠ 在 Windows 10/11 上似乎不起作用，但在 WSL2 中可以工作

使用 VS Code
运行和调试启动器 并在代码中启用完全功能的断点：

1. 定位并选择运行调试。
2. 在下拉菜单中选择标记为“MCP Server Launcher”的配置。
3. 选择运行/调试按钮。
   我们可以使用MCP Inspector 和 VS Code 调试各种工具。

VS Code 调试设置

要设置带断点的本地调试：

1. 在 VS Code 中存储 Brave API 密钥

   • 打开命令面板（Cmd/Ctrl + Shift + P）。
   • 输入 Preferences: Open User Settings (JSON)。
   • 添加以下代码片段：

   {
     "brave.search.api.key": "your-api-key-here"
   }
   

2. 创建或更新 .vscode/launch.json：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "MCP Server Launcher",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}/node_modules/@modelcontextprotocol/inspector/cli/build/cli.js",
      "outFiles": ["${workspaceFolder}/dist/**/*.js"],
      "env": {
        "BRAVE_API_KEY": "${config:brave.search.api.key}",
        "DEBUG": "true"
      },
      "args": ["dist/index.js"],
      "sourceMaps": true,
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen",
      "preLaunchTask": "npm: build:watch"
    },
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to Debug Hook Process",
      "port": 9332,
      "skipFiles": ["<node_internals>/**"],
      "sourceMaps": true,
      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
    },
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to REPL Process",
      "port": 9333,
      "skipFiles": ["<node_internals>/**"],
      "sourceMaps": true,
      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
    }
  ],
  "compounds": [
    {
      "name": "Attach to MCP Server",
      "configurations": ["Attach to Debug Hook Process", "Attach to REPL Process"]
    }
  ]
}

1. 创建 .vscode/tasks.json：

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "npm",
      "script": "build:watch",
      "group": {
        "kind": "build",
        "isDefault": true
      },
      "problemMatcher": ["$tsc"]
    }
  ]
}

免责声明

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

许可证

本项目根据 GNU General Public License v3.0 许可 - 详情请参阅 LICENSE 文件。