Brave Search MCP Server

Brave Search MCP服务器

MCP服务器实现集成了Brave Search API，提供了全面的搜索功能，包括网络搜索、本地商业搜索、地点搜索、图像搜索、视频搜索、新闻搜索、LLM上下文和人工智能摘要。此项目支持STDIO和HTTP传输，默认模式为STDIO。


迁移

1.x到2.x

现在默认传输STDIO

为了遵循既定的MCP惯例，服务器现在默认为STDIO。如果你想继续使用HTTP，你需要设置 BRAVE_MCP_TRANSPORT 环境变量 http，或提供运行时参数 --transport http 启动服务器时。

响应结构 brave_image_search

MCP服务器的1.x版本将返回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 （字符串，可选）：内容过滤（“关闭”、“中等”、“严格”，默认值：“中等”）
• freshness （字符串，可选）：时间过滤器（“pd”、“pw”、“pm”、“py”或日期范围）
• text_decorations （布尔值，可选）：包括突出显示标记（默认值：true）
• spellcheck （布尔值，可选）：启用拼写检查（默认值：true）
• result_filter （数组，可选）：筛选结果类型（默认值：\[“web”，“query”\]）
• goggles （数组，可选）：自定义重新排序定义
• units （字符串，可选）：度量单位（“公制”或“英制”）
• extra_snippets （布尔值，可选）：获取其他摘录（仅限专业版计划）
• summary （布尔值，可选）：启用AI摘要的摘要密钥生成

本地搜索(brave_local_search)

搜索具有详细信息的本地企业和地点，包括评级、营业时间和人工智能生成的描述。

参数：

• 同 brave_web_search 具有自动位置过滤功能
• 自动在result_filter中包含“web”和“位置”

注： 需要Pro计划才能获得完整的本地搜索功能。否则就回到网络搜索。

视频搜索(brave_video_search)

搜索具有全面元数据和缩略图信息的视频。

参数：

• query （字符串，必填）：搜索词（最多400个字符，50个单词）
• country （字符串，可选）：国家代码（默认值：“US”）
• search_lang （字符串，可选）：搜索语言（默认：“en”）
• ui_lang （字符串，可选）：用户界面语言（默认：“en-US”）
• count （数字，可选）：每页结果（1-50，默认值：20）
• offset （数字，可选）：分页偏移量（最大9，默认值：0）
• spellcheck （布尔值，可选）：启用拼写检查（默认值：true）
• safesearch （字符串，可选）：内容过滤（“关闭”、“中等”、“严格”，默认值：“中等”）
• freshness （字符串，可选）：时间过滤器（“pd”、“pw”、“pm”、“py”或日期范围）

图片搜索(brave_image_search)

搜索具有自动提取和base64编码的图像以直接显示。

参数：

• query （字符串，必填）：搜索词（最多400个字符，50个单词）
• country （字符串，可选）：国家代码（默认值：“US”）
• search_lang （字符串，可选）：搜索语言（默认：“en”）
• count （数字，可选）：每页结果（1-200，默认值：50）
• safesearch （字符串，可选）：内容过滤（“关闭”，“严格”，默认：“严格”）
• 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 （字符串，可选）：内容过滤（“关闭”、“中等”、“严格”，默认值：“中等”）
• freshness （字符串，可选）：时间过滤器（默认值：“pd”表示过去24小时）
• extra_snippets （布尔值，可选）：获取其他摘录（仅限专业版计划）
• goggles （数组，可选）：自定义重新排序定义

摘要生成器搜索(brave_summarizer)

使用Brave的摘要API从web搜索结果生成AI摘要。

参数：

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

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

地点搜索(brave_place_search)

使用Brave‘s Place Search API搜索指定地理区域中的兴趣点（POI）。返回丰富、结构化的地点数据，包括名称、地址、开放时间、联系信息、评级、照片、类别和时区。

参数：

• query （字符串，可选）：用于优化POI搜索的查询字符串（最多400个字符，50个单词）。如果省略，则返回所提供区域中的一般兴趣点。
• latitude （数字，可选）：搜索中心的纬度（-90到90）。通常与 longitude.
• longitude （数字，可选）：搜索中心的经度（-180到180）。通常与 latitude.
• location （string，可选）：位置字符串用作 latitude/longitude。对于美国地区，请选择以下表格 （例如。， san francisco ca united states)；适用于非美国地区 （例如。， tokyo japan).
• radius （数字，可选）：在提供的坐标周围搜索半径，单位为米。如果省略，则全局执行搜索。
• count （number，可选）：要返回的结果数（1-50，默认值20）。
• country （字符串，可选）：两个字母的国家代码（默认值 US).
• search_lang （字符串，可选）：搜索语言（默认 en).
• ui_lang （字符串，可选）：UI语言（默认 en-US).
• units （字符串，可选）：距离单位(metric 或 imperial，默认值 metric).
• safesearch （字符串，可选）：安全搜索级别(off, moderate, strict，默认值 strict).
• spellcheck （boolean，可选）：是否对查询进行拼写检查（默认 true).
• geoloc （字符串，可选）：用于优化结果的可选地理定位标记。

可选请求标头：

• api-version （字符串，可选）：勇敢的API版本(YYYY-MM-DD)
• accept （字符串，可选）：响应媒体类型(application/json 或 */*)
• cache-control （字符串，可选）：使用 no-cache 请求新鲜内容
• user-agent （string，可选）：发起请求的用户代理

LLM背景(brave_llm_context)

检索针对AI代理、LLM基础和RAG管道优化的预提取web内容。

参数：

• query （字符串，必填）：搜索查询（最多400个字符，50个单词）
• country （字符串，可选）：搜索国家代码
• search_lang （字符串，可选）：搜索语言代码
• count （数字，可选）：考虑的最大搜索结果数（1-50）
• spellcheck （布尔值，可选）：启用拼写检查
• maximum_number_of_urls （数字，可选）：要包含的URL的最大数量（1-50）
• maximum_number_of_tokens （数字，可选）：上下文标记的大致最大数量（1024-32768）
• maximum_number_of_snippets （number，可选）：要包含的最大片段数（1-256）
• context_threshold_mode （字符串，可选）：阈值模式（“禁用”、“严格”、“宽松”、“平衡”）
• maximum_number_of_tokens_per_url （数字，可选）：每个URL的最大令牌数（512-8192）
• maximum_number_of_snippets_per_url （数字，可选）：每个URL的最大片段数（1-100）
• goggles （字符串或数组，可选）：用于自定义重新排名的Goggle URL或定义
• freshness （字符串，可选）：时间过滤器（“pd”、“pw”、“pm”、“py”或日期范围）
• enable_local （布尔值，可选）：启用本地回调
• enable_source_metadata （布尔值，可选）：包括源元数据丰富

可选请求标头：

• x-loc-lat （数字，可选）：客户纬度（-90到90）
• x-loc-long （数字，可选）：客户端经度（-180到180）
• x-loc-city （字符串，可选）：客户端城市名称
• x-loc-state （字符串，可选）：客户端状态或地区代码
• x-loc-state-name （字符串，可选）：客户端状态或区域名称
• x-loc-country （字符串，可选）：客户国家代码
• x-loc-postal-code （字符串，可选）：客户端邮政编码
• api-version （字符串，可选）：勇敢的API版本(YYYY-MM-DD)
• accept （字符串，可选）：响应媒体类型（“application/json”或“*/*")
• cache-control （字符串，可选）：使用 no-cache 请求新鲜内容
• user-agent （string，可选）：发起请求的用户代理

配置

获取API密钥

1. 注册一个 勇敢搜索API帐户
2. 选择一个计划：

- 搜索：您的聊天机器人和代理生成答案所需的实时搜索数据。完整的搜索结果（URL、文本、新闻、图像等），以及针对AI优化的额外LLM上下文。 - 答案：对任何问题的总结、完整答案。答案基于单次搜索或多次搜索，以提高准确性并减少幻觉。

1. 从生成API密钥 开发人员仪表板

环境变量

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

• BRAVE_API_KEY：您的勇敢搜索API密钥（必需）
• BRAVE_MCP_TRANSPORT：传输模式（“http”或“stdio”，默认值：“stdio“）
• BRAVE_MCP_PORT：HTTP服务器端口（默认值：8000）
• BRAVE_MCP_HOST：HTTP服务器主机（默认值：“0.0.0.0”）
• BRAVE_MCP_LOG_LEVEL：所需的日志记录级别（“调试”、“信息”、“通知”、“警告”、“错误”、“严重”、“警报”或“紧急”，默认值：“信息”）
• BRAVE_MCP_ENABLED_TOOLS：使用时，为支持的工具指定一个空格分隔的白名单
• BRAVE_MCP_DISABLED_TOOLS：使用时，为支持的工具指定一个空格分隔的黑名单
• BRAVE_MCP_STATELESS：HTTP无状态模式（默认值：“true”）。在Amazon Bedrock Agentcore上运行时，设置为“true”。

命令行选项

node dist/index.js [options]

Options:
  --brave-api-key     Brave API key
  --transport     Transport type (default: stdio)
  --port              HTTP server port (default: 8080)
  --host              HTTP server host (default: 0.0.0.0)
  --logging-level     Desired logging level (one of _debug_, _info_, _notice_, _warning_, _error_, _critical_, _alert_, or _emergency_)
  --enabled-tools             Tools whitelist (only the specified tools will be enabled)
  --disabled-tools            Tools blacklist (included tools will be disabled)
  --stateless        HTTP Stateless flag

安装

使用Claude Desktop

将此添加到您的 claude_desktop_config.json:

码头工人

{
  "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": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

使用VS代码

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

](https://insiders.vscode.dev/redirect/mcp/install?name=brave-search&inputs=%5B%7B%22password%22%3Atrue%2C%22id%22%3A%22brave-api-key%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22Brave+Search+API+Key%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) ](https://insiders.vscode.dev/redirect/mcp/install?name=brave-search&inputs=%5B%7B%22password%22%3Atrue%2C%22id%22%3A%22brave-api-key%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22Brave+Search+API+Key%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）或 .vscode/mcp.json:

码头工人

{
  "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 build -t mcp/brave-search:latest .

本地建设

npm install
npm run build

发展

先决条件

• Node.js 22.x或更高版本
• npm
• 勇敢搜索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.json:

{
  "mcpServers": {
    "brave-search-dev": {
      "command": "node",
      "args": ["C:\\GitHub\\brave-search-mcp-server\\dist\\index.js"], // Verify your path
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

通过MCP检查员进行测试

1. 构建并启动服务器：

npm run build
node dist/index.js

1. 在另一个终端中，启动MCP检查器：

npx @modelcontextprotocol/inspector node dist/index.js

STDIO是默认模式。对于HTTP模式测试，添加 --transport http 到检查器UI中的参数。

可用脚本

• npm run build：构建TypeScript项目

• npm run watch：观察变化并重建

• npm run format：使用Prettier格式化代码

• npm run format:check：检查代码格式

• npm run prepare：格式化和构建（在npm install上自动运行）

• npm run inspector：启动MCP Inspector的实例

• npm run inspector:stdio：启动配置为STDIO的MCP Inspector实例

Docker Compose

使用Docker进行本地开发：

docker-compose up --build

许可证

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