@suthio/勇敢深入研究mcp
一种模型上下文协议（MCP）服务器，将Brave Search与Puppeter支持的内容提取相结合，以实现深度研究功能。该服务器允许AI助手执行全面的网络搜索，不仅可以检索搜索结果，还可以访问页面以提取完整内容并探索链接页面。
与标准Brave Search MCP服务器的比较
标准Brave搜索MCP服务器：
- 搜索能力：使用Brave Search API执行基本的web搜索
- 数据检索：仅返回API提供的搜索结果（标题、URL和代码段）
- 内容深度：无法访问搜索片段以外的完整网页内容
- 页面探索：无法访问页面或跟踪链接
- 信息范围：仅限于搜索结果中提供的简要信息
- 内容处理：没有内容提取或清洁功能
- 定制：仅限于基本搜索参数（查询、计数、偏移）
- 用例：最适合只需要概述的快速搜索
Brave Deep Research MCP服务器（本项目）：
- 搜索能力：使用Brave Search API获取初始结果，然后通过web抓取进行增强
- 数据检索：从每个搜索结果中提取完整的页面内容
- 内容深度：提供完整的网页内容，并提取主要文本
- 页面探索：可以遍历链接，以可配置的深度探索相关内容
- 信息范围：跨多个相关页面访问全面信息
- 内容处理：智能识别和提取主要内容，过滤掉导航、广告、页脚等。
- 定制：可配置的探索深度、结果计数、无头模式和超时
- 用例：非常适合需要详细信息和背景的深入研究
示例查询中的实际差异
对于“气候变化减缓技术”这样的问题：
标准勇敢搜索MCP:
Title: "Latest Climate Change Mitigation Technologies - Example Site"
URL: "https://example.com/climate-tech"
Snippet: "Various technologies are being developed to mitigate climate change, including carbon capture..."（仅限于这些搜索结果片段）
勇敢深入研究MCP:
# Latest Climate Change Mitigation Technologies - Example Site
URL: https://example.com/climate-tech
## Content
Carbon capture and storage (CCS) technology has advanced significantly in recent years. The latest direct air capture facilities can now remove CO2 at a cost of $250 per ton, down from $600 just five years ago. Implementation challenges remain, including...
[Followed by several pages of detailed content from the original page and linked pages]特性
- 深度搜索：超越搜索结果，提取完整的页面内容
- 可配置深度：指定从初始结果中遵循的链接级别
- 内容提取：智能识别并提取页面中的主要内容
- 元数据抽取：获取标题、描述和结构化内容
- 调试模式：用于故障排除的可配置日志记录
- 无头模式切换：以可见或无头模式运行浏览器
安装
# Install from npm
npm install -g @suthio/brave-deep-research-mcp
# Or clone the repository
git clone https://github.com/suthio/brave-deep-research-mcp.git
cd brave-deep-research-mcp
npm install
npm run build配置
创建一个 .env 基于提供的文件 .env.example:
# Copy the example env file
cp .env.example .env
# Edit the file to add your Brave API key and other settings
nano .env环境变量
BRAVE_API_KEY：您的勇敢搜索API密钥（必需）PUPPETEER_HEADLESS：是否在无头模式下运行Puppeteer（默认值：true）PAGE_TIMEOUT：页面加载超时（毫秒）（默认值：30000）DEBUG_MODE：启用详细的调试日志记录（默认值：false）
用法
从命令行运行
# If installed globally via npm
brave-deep-research-mcp
# Or run directly from the package
npx @suthio/brave-deep-research-mcp
# Or run locally after cloning
npm start使用Claude for Desktop
要将此服务器与Claude for Desktop一起使用，请执行以下操作：
- 安装软件包：
npm install -g @suthio/brave-deep-research-mcp- 编辑Claude for Desktop配置文件：
- 在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json - 在Windows上： %APPDATA%\Claude\claude_desktop_config.json
- 将以下内容添加到
mcpServers章节：
{
"mcpServers": {
"brave-deep-research": {
"command": "npx",
"args": ["@suthio/brave-deep-research-mcp"],
"env": {
"BRAVE_API_KEY": "your_brave_api_key_here",
"PUPPETEER_HEADLESS": "true"
}
}
}
}- 重新启动桌面版的Claude
- 现在，您可以在对话中使用深度搜索工具
查询示例
- “使用深度搜索来研究量子计算的最新发展”
- “对气候变化缓解策略进行深度搜索2”
- “深入搜索可持续建筑信息，有5个结果”
刀具参数
这 deep-search 工具接受以下参数：
query（必填）：搜索查询results（可选）：要处理的搜索结果数（默认值：3，最大值：10）depth（可选）：每个结果的链接遍历深度（默认值：1，最大值：3）
发展
# Clone the repository
git clone https://github.com/suthio/brave-deep-research-mcp.git
cd brave-deep-research-mcp
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build the project
npm run build运作原理
- 该工具首先使用Brave search API进行搜索以获得初始结果
- 对于每个搜索结果，它都会启动一个Puppeter浏览器来访问该页面
- 它从每个页面提取主要内容、元数据和链接
- 如果深度>1，它会跟随页面上的链接并重复该过程
- 所有提取的内容都被格式化并返回给AI助手
许可证
麻省理工学院