SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI搜索引擎brave-search-mcp

brave-search-mcp

brave-search-mcp 是一个 MCP（Model Context Protocol）服务器实现，用于将 Brave Search API 集成到 AI 应用中。它提供网页搜索、图像搜索、新闻搜索、视频搜索、本地兴趣点搜索以及面向大语言模型的上下文搜索能力。该工具以 stdio 模式运行，也可启用 Streamable HTTP 模式，支持通过环境变量或 TOML 配置文件进行功能设置，并支持 OpenAI Apps 与 MCP Apps 的 UI 模式。

访问官网

工具介绍

brave-search-mcp 是一个 MCP Server 实现，用于集成 Brave Search API，为 AI 应用提供多种搜索能力。

用途

该工具旨在让 AI 代理、LLM 应用或 RAG 管道能够通过标准化的 MCP 协议调用 Brave 搜索服务，获取网页、图像、新闻、视频、本地兴趣点以及经过预提取的网页内容。

主要能力

  • Web Search（brave_web_search）：执行常规网页搜索。输入参数包括 query（搜索词）、count（返回结果数，最大 20，默认 10）、offset（分页偏移，默认 0）、freshness（按发现时间过滤，支持 pd、pw、pm、py 或自定义日期范围 YYYY-MM-DDtoYYYY-MM-DD）。
  • Image Search（brave_image_search）：搜索网络图像。输入参数包括 query、count（最大 50，默认 10）。
  • News Search（brave_news_search）：搜索新闻。输入参数包括 query、count（最大 20，默认 10）、offset（最大 9）、freshness（同 Web Search）。
  • Local Points of Interest Search（brave_local_search）：搜索本地商家、服务和兴趣点。输入参数包括 query、count（最大 20，默认 5）、offset（最大 9）。若初始页面未找到位置结果，会回退到 brave_web_search。
  • Video Search（brave_video_search）：搜索视频。输入参数包括 query、count（最大 20，默认 10）、offset（最大 9）、freshness（同 Web Search）。
  • LLM Context Search（brave_llm_context_search）：获取并提取针对阅读和综合来源优化的完整网页内容，适用于 AI 代理、LLM grounding 和 RAG 管道。compact 模式使用 Brave 的平衡上下文阈值模式，full 模式禁用 Brave 相关性过滤。输入参数包括 query（最大 400 字符、50 词）、url（可选，指定后仅返回该 URL 的片段）、count（默认 8，范围 1-50）、maximumNumberOfUrls（默认 8，范围 1-50）、maximumNumberOfTokens（默认 2048，范围 1024-32768）、maximumNumberOfSnippets（默认 16，范围 1-100）、maximumNumberOfTokensPerUrl（默认 512，范围 512-8192）、maximumNumberOfSnippetsPerUrl（默认 2，范围 1-100）、responseMode（compact 或 full，默认 compact）、maxSnippetChars（默认 400，范围 80-4000）、maxOutputChars（默认 8000，范围 1000-100000）。

使用方式

  • 需要先注册 Brave Search API 账户，并在开发者仪表板生成 API 密钥。
  • 默认以 stdio 模式运行。
  • 可启用 Streamable HTTP 模式，默认监听端口 3001，URL 为 http://localhost:3001/mcp（根据资料推断，实际 URL 未明确给出完整路径，仅说明默认端口 3001）。
  • 配置模式有两种：
    • Env 模式：未设置 BRAVE_MCP_CONFIG，功能开关来自环境变量。
    • File 模式：设置 BRAVE_MCP_CONFIG=/path/to/config.toml，TOML 文件成为功能设置的唯一来源，重叠的功能环境变量会被忽略并发出警告。
  • 环境变量设置（始终从进程环境读取）：BRAVE_API_KEY（必需）、PORT（可选，默认 3001）、HOST（可选，默认 0.0.0.0）、BRAVE_MCP_CONFIG（可选）。
  • Env 模式功能设置：ALLOWED_HOSTS（仅 HTTP 模式，逗号分隔的主机名列表，用于 Host 头验证，例如 ALLOWED_HOSTS=localhost,127.0.0.1,my-app.ngrok-free.app，仅使用主机名，不含协议或路径）。
  • 支持 OpenAI Apps 和 MCP Apps：当为每个工具启用 UI 模式时，会有对应的 UI 小部件，可控制添加到模型上下文的内容。

适用场景

  • 为 AI 代理提供实时网络搜索能力。
  • 构建需要图像、新闻、视频或本地信息的 AI 应用。
  • 为 LLM 提供经过预提取和优化的网页内容，用于 RAG 或 grounding。
  • 通过 MCP 协议集成到支持该协议的 AI 开发平台或聊天应用中。

限制

  • 需要有效的 Brave Search API 密钥。
  • 各搜索工具的返回数量、偏移量、freshness 等参数有明确上限。
  • LLM Context Search 的 query 有字符和词数限制。
  • 资料未提供具体的安装命令、代码示例、收费信息或平台兼容性细节，这些内容暂未提供。

同类工具

查看分类