Pothole MCP Server

Brave 搜索 MCP 服务器

一个集成了Brave Search API的MCP服务器实现，提供网页和本地搜索功能。

特点/特性

• 网页搜索常规查询、新闻、文章，支持分页和新鲜度控制
• 本地搜索查找带有详细信息的企业、餐厅和服务
• 灵活过滤控制结果类型、安全级别和内容的新鲜度
• 智能回退方案当未找到结果时，本地搜索会自动转至网页搜索

工具

• 勇敢网页搜索

- 执行带分页和过滤功能的网页搜索 - 输入： - query (字符串)：搜索词 - count （数字，可选）：每页显示的结果数量（最多20个） - offset （数字，可选）：分页偏移量（最大9）

• 勇敢的局部搜索

- 搜索本地商家和服务 - 输入： - query (字符串)：本地搜索词 - count (数字，可选)：结果数量（最多20个） - 如果未找到本地结果，则自动切换到网页搜索

配置

获取API密钥

1. 注册一个 Brave搜索API账户
2. 选择一个计划（提供免费套餐，每月2,000次查询）
3. 生成您的API密钥 来自开发者仪表板

与Claude桌面版的使用

把它加到你的（列表/计划/东西里） claude_desktop_config.json：

Docker（注：Docker是一个用于开发、部署和运行应用程序的开源平台，支持在容器中打包和部署应用，确保应用在任何环境中都能一致地运行。）

{
  "mcpServers": {
    "brave-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRAVE_API_KEY",
        "mcp/brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

在 VS Code 中的使用方法

为了快速安装，请使用下面的一键安装按钮。。。

](https://insiders.vscode.dev/redirect/mcp/install?name=brave&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22BRAVE_API_KEY%22%2C%22mcp%2Fbrave-search%22%5D%2C%22env%22%3A%7B%22BRAVE_API_KEY%22%3A%22%24%7Binput%3Abrave_api_key%7D%22%7D%7D&quality=insiders)

对于手动安装，请将以下JSON代码块添加到VS Code中的用户设置（JSON）文件中。你可以通过按下（相关快捷键或步骤）来完成此操作 Ctrl + Shift + P 并且打字 Preferences: Open User Settings (JSON)。

可选地，您可以将其添加到一个名为（此处可填写文件名）的文件中 .vscode/mcp.json 在您的工作区中。这样您就可以与他人共享此配置。

请注意，该 mcp 无需密钥在（此处） .vscode/mcp.json 文件。

Docker

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "BRAVE_API_KEY",
          "mcp/brave-search"
        ],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}"
        }
      }
    }
  }
}

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-brave-search"],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}"
        }
      }
    }
  }
}

构建

Docker 构建：

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

许可证

此MCP服务器采用MIT许可证授权。这意味着您可以在遵守MIT许可证条款和条件的前提下，自由使用、修改和分发该软件。如需了解更多详情，请参阅项目仓库中的LICENSE文件。