Brave Search MCP Server 是一个 MCP（Model Context Protocol）服务器实现，集成了 Brave Search API，为支持 MCP 的客户端提供搜索能力。项目支持 STDIO 和 HTTP 两种传输方式，默认使用 STDIO；如需使用 HTTP，可将环境变量 BRAVE_MCP_TRANSPORT 设为 http，或在启动时传入 --transport http 参数。
主要工具与能力 网页搜索（brave_web_search）：执行综合网页搜索，支持国家、搜索语言、界面语言、每页结果数（1-20，默认 10）、分页偏移、安全搜索级别（off/moderate/strict，默认 moderate）、时效过滤（pd、pw、pm、py 或日期区间）、文本高亮、拼写检查、结果类型过滤、自定义重排（goggles）、单位制、额外摘要以及摘要键生成等参数。 本地搜索（brave_local_search）：搜索本地商户与地点，返回评分、营业时间及 AI 生成描述等信息，会自动加入位置过滤并包含 web 与 locations 结果类型。完整本地搜索能力需要 Pro 套餐，否则回退为网页搜索。 视频搜索（brave_video_search）：搜索视频并返回元数据与缩略图信息，每页结果数 1-50，默认 20。 图片搜索（brave_image_search）：搜索图片并返回 URL、尺寸和置信度等元数据，每页结果数 1-200，默认 50，安全搜索默认 strict。 新闻搜索（brave_news_search）：搜索当前新闻文章，支持时效控制并带有突发新闻指示，时效默认 pd（最近 24 小时）。 摘要搜索（brave_summarizer）：使用 Brave 摘要 API 基于网页搜索结果生成 AI 摘要。使用前需先执行带 summary: true 的网页搜索，再用返回的 summary key 调用该工具；可选包含实体信息与内联来源链接。 地点搜索（brave_place_search）：在指定地理区域内搜索兴趣点，返回名称、地址、营业时间、联系方式、评分、照片、分类和时区等结构化数据。支持查询词、经纬度、位置字符串、半径（米）、结果数量（1-50，默认 20）、国家、搜索语言、界面语言、单位制、安全搜索、拼写检查等参数，并支持可选请求头 api-version、accept、cache-control、user-agent。 LLM 上下文（brave_llm_context）：获取为 AI 智能体、LLM 接地与 RAG 流程优化的预抽取网页内容。支持查询、国家、搜索语言、结果数量、拼写检查、最大 URL 数（1-50）、最大 token 数（1024-32768）、最大片段数（1-256）、阈值模式、每 URL 最大 token 数与片段数、goggles、本地召回、来源元数据增强以及客户端位置信息等参数。
版本变化 1.x 版本会同时返回 base64 编码的图片数据和图片 URL，响应较慢且占用会话上下文；2.x 版本移除了 base64 数据，返回更贴近原始 Brave Search API 的响应对象，输出结构定义于 src/tools/images/schemas/output.ts。
获取 API 密钥与套餐 需注册 Brave Search API 账号，可选套餐包括：Search（为聊天机器人和智能体提供实时搜索数据，包含完整搜索结果以及面向 AI 优化的 LLM 上下文）、Answers（对任意问题生成摘要式完整回答，可基于单次或多次搜索以提升准确性并减少幻觉）。密钥需在开发者仪表盘生成。
环境变量 BRAVE_API_KEY：Brave Search API 密钥（未设置 BRAVE_API_KEY_FILE 时必填）。 BRAVE_API_KEY_FILE：包含密钥的文件路径，设置后优先于 BRAVE_API_KEY，适用于 Docker secrets 等挂载密钥场景。 BRAVE_MCP_TRANSPORT：传输模式（http 或 stdio，默认 stdio）。 BRAVE_MCP_PORT：HTTP 服务器端口（默认 8080）。 BRAVE_MCP_HOST：HTTP 服务器主机（默认 127.0.0.1，仅绑定回环地址；设为 0.0.0.0 可暴露到所有接口，容器内与 Amazon Bedrock AgentCore 上需要，但 HTTP 端点未认证，只应在可信网络中使用）。 BRAVE_MCP_ALLOWED_ORIGINS：HTTP 传输允许的额外 Origin 值，空格或逗号分隔；回环来源始终允许，其他来源的浏览器请求返回 HTTP 403 以防 DNS 重绑定。 BRAVE_MCP_ALLOWED_HOSTS：HTTP 传输 Host 头允许的主机名列表，空格或逗号分隔，仅按主机名匹配且不区分大小写；不设置时默认不校验 Host 头。 BRAVE_MCP_LOG_LEVEL：日志级别（debug、info、notice、warning、error、critical、alert、emergency，默认 info）。 BRAVE_MCP_ENABLED_TOOLS：以空格分隔的工具白名单。 BRAVE_MCP_DISABLED_TOOLS：以空格分隔的工具黑名单。 BRAVE_MCP_STATELESS：HTTP 无状态模式（默认 true）；在 Amazon Bedrock AgentCore 上运行时设为 true。
使用方式 项目提供面向 Claude Desktop、VS Code 等客户端的配置示例，以及本地构建与 MCP Inspector 的测试方式。使用要求为 Node.js 22.x 或更高版本以及 Brave Search API 密钥；MCP Inspector 需要 Node 22.19 或更高版本。常用脚本包括：npm run build（构建 TypeScript 项目）、npm run watch（监听变更并重建）、npm test（运行测试套件）、npm run format（使用 Prettier 格式化代码）、npm run format:check（检查代码格式）、npm run prepare（格式化并构建，npm install 时自动运行）、npm run serve:http（构建后在 http://127.0.0.1:8080/mcp 上以 HTTP 方式提供服务）、npm run inspector（启动 MCP Inspector 实例）、npm run inspector:http（针对上述 HTTP 地址启动 MCP Inspector）。
适用场景 适合需要为聊天机器人、AI 智能体或 RAG 流程接入实时网页搜索、新闻、图片、视频、本地商户与地点信息，或需要获取为 LLM 优化的网页上下文与 AI 摘要的开发者。
限制 本地搜索的完整能力需要 Pro 套餐；额外摘要（extra_snippets）仅 Pro 套餐可用；HTTP 端点未认证，暴露到非回环地址时需在可信网络中谨慎使用。项目采用 MIT 许可证。具体价格与各套餐详细条款以官方页面为准。
