Back to MCP directory
publicPublicdnsLocal runtime

test-server

一个集成Brave搜索API的MCP服务器实现,提供网页搜索和本地搜索功能,支持结果过滤和智能回退机制。

article

README

🚀 勇敢搜索 MCP 服务器

勇敢搜索 MCP 服务器是一个集成了 BraveSearch API 的 MCP 服务实现,它提供了网页搜索和本地搜索两大核心功能,能满足用户多样化的搜索需求。

🚀 快速开始

在使用勇敢搜索 MCP 服务器之前,你需要先完成 API Key 的获取和相关配置,具体步骤如下:

获取 API Key

  1. Brave Search API 账户 注册。
  2. 选择计划(免费层提供每月 2,000 次查询)。
  3. 从开发者仪表盘生成您的 API key 此处

使用 Claude Desktop

将此内容添加到 claude_desktop_config.json

{
  "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"
      }
    }
  }
}

构建

Docker 构建:

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

✨ 主要特性

  • 网页搜索:支持普通查询、新闻、文章搜索,带有分页和新鲜度控制功能,让你可以更精准地获取所需信息。
  • 本地搜索:能够查找企业、餐厅和服务,并提供详细信息,满足你在本地生活中的各种搜索需求。
  • 灵活过滤:可以控制结果类型、安全级别和内容新鲜度,使搜索结果更加符合你的期望。
  • 智能回退:当本地搜索无结果时,会自动回退到网页搜索,确保你总能得到有用的信息。

📚 详细文档

工具

brave_web_search

  • 功能:带分页和过滤执行网页搜索。
  • 输入:
    • query (字符串):搜索词。
    • count (数字,可选):每页结果数(最大值20)。
    • offset (数字,可选):分页偏移量(最大9)。

brave_local_search

  • 功能:搜索本地企业和服务。
  • 输入:
    • query (字符串):本地搜索词。
    • count (数字,可选):结果数量(最大值20)。
  • 特性:在无本地结果时自动回退到网页搜索。

📄 许可证

此 MCP 服务器根据 MIT License 发布。这意味着您可以自由使用、修改和分发软件,但需遵守 MIT 许可证的条款和条件。更多详细信息,请参阅项目存储库中的 LICENSE 文件。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client