返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端