一个集成Brave Search API的MCP服务器实现，提供包括网页搜索、本地商家搜索、地点搜索、图片搜索、视频搜索在内的全面搜索功能,...
概览
一个集成Brave Search API的MCP服务器实现，提供包括网页搜索、本地业务搜索、地点搜索、图片搜索、视频搜索、新闻搜索、大型语言模型上下文和AI驱动摘要在内的综合搜索功能。该项目支持STDIO和HTTP传输，默认模式为STDIO。 为了遵循既定的MCP惯例，服务器现在默认使用STDIO。如果你想继续使用HTTP，需要将BRAVE_MCP_TRANSPORT环境变量设置为HTTP，或者在启动服务器时提供运行时参数--transport http。 MCP 服务器的 1.x 版本会返回 base64 编码的图像数据以及图片 URL。这大大减慢了响应速度，并且在会话中消耗了不必要的上下文。2.x 版本移除了 base64 编码的数据，返回了一个更接近原始 Brave Search API 响应的响应对象。
概述（AI 翻译）
一个集成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 的响应结构
MCP 服务器的 1.x 版本会返回 base64 编码的图像数据以及图像 URL。这大大降低了响应速度，并消耗了会话中的不必要上下文。2.x 版本移除了 base64 编码的数据，返回了一个更接近原始 Brave Search API 响应的响应对象。更新后的输出模式定义在 src/tools/images/schemas/output.ts。
工具
网页搜索（brave_web_search）
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
Brave Search MCP Server
An MCP server implementation that integrates the Brave Search API, providing comprehensive search capabilities including web search, local business search, place search, image search, video search, news search, LLM context, and AI-powered summarization. This project supports both STDIO and HTTP transports, with STDIO as the default mode.
Migration
1.x to 2.x
Default transport now STDIO
To follow established MCP conventions, the server now defaults to STDIO. If you would like to continue using HTTP, you will need to set the BRAVE_MCP_TRANSPORT environment variable to http, or provide the runtime argument --transport http when launching the server.
Response structure of brave_image_search
Version 1.x of the MCP server would return base64-encoded image data along with image URLs. This dramatically slowed down the response, as well as consumed unnecessarily context in the session. Version 2.x removes the base64-encoded data, and returns a response object that more closely reflects the original Brave Search API response. The updated output schema is defined in src/tools/images/schemas/output.ts.
Tools
Web Search (brave_web_search)
Performs comprehensive web searches with rich result types and advanced filtering options.
Parameters:
query(string, required): Search terms (max 400 chars, 50 words)country(string, optional): Country code (default: “US”)search_lang(string, optional): Search language (default: “en”)ui_lang(string, optional): UI language (default: “en-US”)count(number, optional): Results per page (1-20, default: 10)offset(number, optional): Pagination offset (max 9, default: 0)safesearch(string, optional): Content filtering (“off”, “moderate”, “strict”, default: “moderate”)freshness(string, optional): Time filter (“pd”, “pw”, “pm”, “py”, or date range)text_decorations(boolean, optional): Include highlighting markers (default: true)spellcheck(boolean, optional): Enable spell checking (default: true)result_filter(array, optional): Filter result types (default: [“web”, “query”])goggles(array, optional): Custom re-ranking definitionsunits(string, optional): Measurement units (“metric” or “imperial”)extra_snippets(boolean, optional): Get additional excerpts (Pro plans only)summary(boolean, optional): Enable summary key generation for AI summarization
Local Search (brave_local_search)
Searches for local businesses and places with detailed information including ratings, hours, and AI-generated descriptions.
Parameters:
- Same as
brave_web_searchwith automatic location filtering - Automatically includes “web” and “locations” in result_filter
安装
docker run -i --rm -e BRAVE_API_KEY docker.io/mcp/brave-search配置
{
"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"
}
}
}
}