项目简介
该项目是一个遵循Model Context Protocol (MCP) 标准实现的服务器,旨在将Brave Search API提供的各种搜索功能暴露给支持MCP协议的大语言模型(LLM)客户端。通过这个服务器,LLM可以根据用户需求调用相应的搜索工具,获取最新的网页信息、图片、视频、新闻或本地地点数据,从而增强其实时信息获取和处理能力。
主要功能点
- 网页搜索: 执行常规网页搜索,获取相关的网页链接和摘要信息。
- 图片搜索: 搜索互联网上的图片,搜索结果中的图片可以作为资源被LLM客户端直接访问和显示。
- 新闻搜索: 搜索最新的新闻报道和热门话题。
- 视频搜索: 搜索互联网上的视频内容。
- 本地地点搜索: 搜索附近的商家、服务或景点(需要Brave Search API的Pro计划)。
这些搜索能力被封装成LLM可调用的“工具(Tools)”,图片搜索结果则可作为“资源(Resources)”供模型和客户端使用。
安装步骤
该服务器是基于Node.js环境运行的。通常情况下,您不需要手动克隆代码和安装依赖,可以通过'npx'命令直接运行。
-
获取Brave Search API Key:
- 访问 Brave Search API 网站 注册账号。
- 选择合适的API计划(免费计划每月有2000次查询额度)。
- 从开发者仪表盘 https://api.search.brave.com/app/keys 生成您的API Key。
-
设置API Key: 运行MCP服务器时,需要通过环境变量'BRAVE_API_KEY'提供您的API Key。这通常在配置MCP客户端时完成。
MCP客户端配置
MCP服务器通常由MCP客户端(如Claude Desktop, LibreChat等)根据配置启动。以下是配置MCP客户端连接到此Brave搜索MCP服务器所需的关键信息说明:
您需要在MCP客户端的配置文件(例如 'claude_desktop_config.json' 或 'librechat.yaml')中,找到或创建MCP服务器的配置节。配置内容通常是一个JSON对象,指定了如何启动和连接到服务器。
主要的配置项包括:
- 'name': 服务器的内部名称,例如 'brave-search'。
- 'command': 启动服务器的可执行命令,对于这个项目,通常是 'npx'。
- 'args': 传递给命令的参数。使用 'npx' 运行时,参数通常是 '-y brave-search-mcp'。
- 'env': 启动服务器进程时设置的环境变量。必须在此处设置 'BRAVE_API_KEY' 环境变量,并将其值设为您获取到的Brave Search API Key。
注意: 具体的配置格式和位置取决于您使用的MCP客户端。请参考您MCP客户端的文档来找到配置MCP服务器的部分。
例如,在某个客户端中,您可能需要类似如下的配置结构(请勿直接复制此代码,参考并根据您的客户端文档填写):
{ "mcp-servers": { "brave-search": { "command": "npx", "args": [ "-y", "brave-search-mcp" ], "env": { "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE" // 将 YOUR_BRAVE_API_KEY_HERE 替换为您的实际API Key } } } }
基本使用方法
一旦在您的MCP客户端中配置并成功启动了Brave搜索MCP服务器,您就可以像往常一样与LLM进行交互。当您的查询需要外部信息(例如“搜索关于...的最新新闻”、“帮我查找附近的...餐厅”等)时,LLM会识别出可以利用Brave搜索MCP服务器提供的工具,并自动调用相应的工具执行搜索,然后将搜索结果融入到回复中或展示给您。您无需直接与MCP服务器交互。
信息
分类
网页与API