Brave Search MCP Server

这是一个 MCP 服务器实现，集成了 Brave Search API，提供全面的搜索能力，包括网页搜索、本地商家搜索、地点搜索、图片搜索、视频搜索、新闻搜索、LLM 上下文以及 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）

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

参数：

• 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 摘要生成启用 summary 键

本地搜索（brave_local_search）

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

参数：

• 与 brave_web_search 相同，但会自动进行位置过滤
• 自动在 result_filter 中包含 "web" 和 "locations"

注意： 需要 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（字符串，可选）：内容过滤（"off"、"moderate"、"strict"，默认："moderate"）
• freshness（字符串，可选）：时间过滤（"pd"、"pw"、"pm"、"py" 或日期范围）

图片搜索（brave_image_search）

搜索图片，提供包括 URL、尺寸和置信度分数在内的元数据。

参数：

• 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）