STARWARCLOUD STARWAR.AI
返回市场
勇敢搜索MCP服务器

勇敢搜索MCP服务器

作者：brave358 星标更新：2025-11-22
安装使用来源：spider==github.com

项目介绍

Brave Search MCP 服务器

这是一个集成了Brave Search API的MCP服务器实现，提供全面的搜索功能，包括网页搜索、本地商业搜索、图片搜索、视频搜索、新闻搜索以及AI驱动的摘要生成。该项目支持STDIO和HTTP传输模式，默认使用STDIO模式。

迁移

从1.x到2.x

默认传输模式现在是STDIO

为了遵循已建立的MCP规范，服务器现在默认使用STDIO。如果您希望继续使用HTTP，请设置环境变量BRAVE_MCP_TRANSPORT为http，或在启动服务器时提供运行时参数--transport http。

brave_image_search响应结构

1.x版本的MCP服务器会返回base64编码的图像数据以及图像URL。这大大减慢了响应速度，并且在会话中不必要地消耗了上下文。2.x版本删除了base64编码的数据，返回一个更接近原始Brave Search API响应的对象。更新后的输出模式定义在src/tools/images/schemas/output.ts。

工具

网页搜索 (brave_web_search)

执行全面的网页搜索，具有丰富的结果类型和高级过滤选项。

参数：

  • query (字符串，必需)：搜索词（最大400字符，50个单词）
  • country (字符串，可选)：国家代码（默认："US"）
  • search_lang (字符串，可选)：搜索语言（默认："en"）
  • ui_lang (字符串，可选)：界面语言（默认："en-US"）
  • count (数字，可选)：每页结果数（1-20，默认：10）
  • offset (数字，可选)：分页偏移量（最大9，默认：0）
  • safesearch (字符串，可选)：内容过滤（"off"，"moderate"，"strict"，默认："moderate"）
  • freshness (字符串，可选)：时间过滤（"pd"，"pw"，"pm"，"py"或日期范围）
  • text_decorations (布尔值，可选)：包含高亮标记（默认：true）
  • spellcheck (布尔值，可选)：启用拼写检查（默认：true）
  • result_filter (数组，可选)：过滤结果类型（默认：["web"，"query"]）
  • goggles (数组，可选)：自定义重新排序定义
  • units (字符串，可选)：度量单位（"metric"或"imperial"）
  • extra_snippets (布尔值，可选)：获取额外摘录（仅限Pro计划）
  • summary (布尔值，可选)：启用AI摘要生成

本地搜索 (brave_local_search)

搜索本地企业及地点，提供详细信息，包括评分、营业时间和AI生成的描述。

参数：

  • 同brave_web_search，自动进行位置筛选
  • 自动包含"web"和"locations"在结果过滤器中

注意： 需要Pro计划才能使用完整的本地搜索功能。否则将回退至网页搜索。

视频搜索 (brave_video_search)

搜索视频，提供全面的元数据和缩略图信息。

参数：

  • query (字符串，必需)：搜索词（最大400字符，50个单词）
  • country (字符串，可选)：国家代码（默认："US"）
  • search_lang (字符串，可选)：搜索语言（默认："en"）
  • ui_lang (字符串，可选)：界面语言（默认："en-US"）
  • count (数字，可选)：每页结果数（1-50，默认：220）
  • offset (数字，可选)：分页偏移量（最大9，默认：0）
  • spellcheck (布尔值，可选)：启用拼写检查（默认：true）
  • safesearch (字符串，可选)：内容过滤（"off"，"moderate"，"strict"，默认："moderate"）
  • freshness (字符串，可选)：时间过滤（"pd"，"pw"，"pm"，"py"或日期范围）

图片搜索 (brave_image_search)

搜索图片，自动抓取并以base64编码直接显示。

参数：

  • query (字符串，必需)：搜索词（最大400字符，50个单词）
  • country (字符串，可选)：国家代码（默认："US"）
  • search_lang (字符串，可选)：搜索语言（默认："en"）
  • count (数字，可选)：每页结果数（1-200，默认：50）
  • safesearch (字符串，可选)：内容过滤（"off"，"strict"，默认："strict"）
  • spellcheck (布尔值，可选)：启用拼写检查（默认：true）

新闻搜索 (brave_news_search)

搜索当前新闻文章，具备新鲜度控制和突发新闻指示。

参数：

  • query (字符串，必需)：搜索词（最大400字符，50个单词）
  • country (字符串，可选)：国家代码（默认："US"）
  • search_lang (字符串，可选)：搜索语言（默认："en"）
  • ui_lang (字符串，可选)：界面语言（默认："en-US"）
  • count (数字，可选)：每页结果数（1-50，默认：20）
  • offset (数字，可选)：分页偏移量（最大9，默认：0）
  • spellcheck (布尔值，可选)：启用拼写检查（默认：true）
  • safesearch (字符串，可选)：内容过滤（"off"，"moderate"，"strict"，默认："moderate"）
  • freshness (字符串，可选)：时间过滤（默认："pd"，即过去24小时）
  • extra_snippets (布尔值，可选)：获取额外摘录（仅限Pro计划）
  • goggles (数组，可选)：自定义重新排序定义

摘要搜索 (brave_summarizer)

使用Brave的摘要API从网页搜索结果生成AI驱动的摘要。

参数：

  • key (字符串，必需)：来自网页搜索结果的摘要键（使用summary: true在网页搜索中）
  • entity_info (布尔值，可选)：包含实体信息（默认：false）
  • inline_references (布尔值，可选)：添加来源URL引用（默认：false）

用法： 首先使用summary: true执行网页搜索，然后使用返回的摘要键与此工具。

配置

获取API密钥

  1. 注册一个Brave Search API账户
  2. 选择一个计划：
    • 免费：每月2,000次查询，基本网页搜索
    • Pro：增强功能，包括本地搜索、AI摘要、额外摘录
  3. 从开发者仪表板生成您的API密钥

环境变量

服务器支持以下环境变量：

  • BRAVE_API_KEY：您的Brave Search API密钥（必需）
  • BRAVE_MCP_TRANSPORT：传输模式（"http"或"stdio"，默认："stdio"）
  • BRAVE_MCP_PORT：HTTP服务器端口（默认：8080）
  • BRAVE_MCP_HOST：HTTP服务器主机（默认："0.0.0.0"）
  • BRAVE_MCP_LOG_LEVEL：期望的日志级别（"debug"，"info"，"notice"，"warning"，"error"，"critical"，"alert"或"emergency"，默认："info"）
  • BRAVE_MCP_ENABLED_TOOLS：当使用时，指定支持工具的白名单
  • BRAVE_MCP_DISABLED_TOOLS：当使用时，指定支持工具的黑名单

命令行选项

node dist/index.js [选项]

选项：
  --brave-api-key <字符串>    Brave API密钥
  --transport <stdio|http>    传输类型（默认：stdio）
  --port <数字>               HTTP服务器端口（默认：8080）
  --host <字符串>             HTTP服务器主机（默认：0.0.0.0）
  --logging-level <字符串>    期望的日志级别（之一：_debug_，_info_，_notice_，_warning_，_error_，_critical_，_alert_或_emergency_）
  --enabled-tools             工具白名单（仅启用指定的工具）
  --disabled-tools            工具黑名单（禁用包含的工具）

安装

通过Smithery安装

要通过Smithery自动安装Brave Search：

npx -y @smithery/cli install brave

在Claude Desktop中的使用

将以下内容添加到您的claude_desktop_config.json中：

Docker

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

NPX

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@brave/brave-search-mcp-server", "--transport", "http"],
      "env": {
        1. "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

在VS Code中的使用

快速安装，使用下面的一键安装按钮：

通过NPX在VS Code中安装 通过NPX在VS Code Insiders中安装
通过Docker在VS Code中安装 通过Docker在VS Code Insiders中安装

手动安装，将以下内容添加到您的用户设置（JSON）或.vscode/mcp.json中：

Docker

{
  "inputs": [
    {
      "password": true,
      "id": "brave-api-key",
      "type": "promptString",
      "description": "Brave Search API Key",
    }
  ],
  "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

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

构建

Docker

docker build -t mcp/brave-search:latest .

本地构建

npm install
npm run build

开发

先决条件

  • Node.js 22.x或更高版本
  • npm
  • Brave Search API密钥

设置

  1. 克隆仓库：
git clone https://github.com/brave/brave-search-mcp-server.git
cd brave-search-mcp-server
  1. 安装依赖项：
npm install
  1. 构建项目：
npm run build

通过Claude Desktop测试

在`claude_desktop_config