article
README
🚀 勇敢深入研究MCP服务器
本项目是一个结合了Brave Search和Puppeteer网页抓取功能的模型上下文协议(MCP)服务器,旨在实现深度研究能力。该服务器能让AI助手不仅执行基本网络搜索,还可访问并提取完整网页内容,同时探索相关链接页面。
🚀 快速开始
工具参数
deep-search工具接受以下参数:
query(必需):搜索查询results(可选):要处理的搜索结果数量(默认:3,最大:10)depth(可选):每个结果的链接遍历深度(默认:1,最大:3)
开发步骤
# 克隆仓库
git clone https://github.com/suthio/brave-deep-research-mcp.git
cd brave-deep-research-mcp
# 安装依赖项
npm install
# 以开发模式运行
npm run dev
# 构建项目
npm run build
✨ 主要特性
与标准Brave Search MCP服务器的比较
标准Brave Search MCP服务器:
- 搜索能力:使用Brave Search API进行基础网络搜索
- 数据检索:仅返回API提供的搜索结果(标题、URL和snippet)
- 内容深度:无法访问搜索片段之外的完整网页内容
- 页面探索:没有访问页面或跟随链接的能力
- 信息范围:仅限于搜索结果中简要的信息
- 内容处理:无内容提取或清理功能
- 定制化:仅限于基本搜索参数(查询、数量、偏移)
- 用例:适合需要快速概览的场景
勇敢深入研究MCP服务器(本项目):
- 搜索能力:使用Brave Search API进行初步结果,然后通过网络抓取增强
- 数据检索:从每个搜索结果中提取完整的页面内容
- 内容深度:提供整个网页的完整内容和主要文本提取
- 页面探索:可以遍历链接以探索相关内容,默认配置可调整深度
- 信息范围:访问多个相关页面上的全面信息
- 内容处理:智能识别并提取主要内容,过滤掉导航、广告、页脚等
- 定制化:可配置的探索深度、结果数量、无头模式和超时设置
- 用例:适合需要详细信息和上下文的深入研究
示例查询的实际差异
对于“气候变迁缓解技术”这样的查询:
标准Brave Search MCP:
标题:“气候变迁缓解技术”
URL:example.com/climate-mitigation
snippet:提供一些关于气候变迁的技术概述。
勇敢深入研究MCP服务器:
标题:“气候变迁缓解技术”
URL:example.com/climate-mitigation
内容:详细介绍了多种气候变迁缓解技术,包括碳捕捉、可再生能源等,并链接到相关研究论文和实际案例。
子页面1:example.com/renewable-energy 提供关于可再生能源的深入信息。
子页面2:example.com/carbon-capture 详细介绍碳捕获技术。
🔧 技术细节
- 工具首先使用Brave Search API进行搜索,获取初步结果
- 对于每个搜索结果,启动一个Puppeteer浏览器访问页面
- 从每个页面提取主要内容、元数据和链接
- 如果深度>1,则遍历页面上的链接并重复过程
- 所有提取的内容均格式化后返回给AI助手
📄 许可证
本项目采用MIT许可证。
扫码联系在线客服