基本能力
产品定位
MCP Deep Web Research Server 是一个高级网络研究工具，旨在通过智能搜索队列、增强内容提取和深度研究能力，将实时信息整合到 Claude 中。
核心功能
- 智能搜索队列系统
- 批量搜索操作与速率限制
- 队列管理与进度跟踪
- 错误恢复和自动重试
-
搜索结果去重
-
增强内容提取
- 基于 TF-IDF 的相关性评分
- 关键词邻近分析
- 内容部分加权
- 可读性评分
- 改进的 HTML 结构解析
- 结构化数据提取
-
更好的内容清理和格式化
-
核心功能
- Google 搜索集成
- 网页内容提取
- 研究会话跟踪
- 改进格式的 Markdown 转换
适用场景
- 复杂网络研究
- 实时信息整合
- 内容分析和提取
- 批量搜索操作
工具列表
- deep_research
- 执行全面的内容分析研究
- 参数包括主题、最大深度、最大分支、超时和最小相关性分数
-
返回主要主题、关键见解和来源
-
parallel_search
- 并行执行多个 Google 搜索
-
参数包括查询和最大并行数
-
visit_page
- 访问网页并提取其内容
- 返回 URL、标题和 Markdown 格式的内容
常见问题解答
- 速率限制
- 症状："Too many requests" 错误
-
解决方案：增加
SEARCH_DELAY_MS或减少MAX_PARALLEL_SEARCHES -
网络超时
- 症状："Request timed out" 错误
-
解决方案：确保请求在 60 秒的 MCP 超时内完成
-
浏览器问题
- 症状："Browser failed to launch" 错误
- 解决方案：确保 Playwright 正确安装 (
npx playwright install)
使用教程
使用依赖
- Node.js >= 18 (包括
npm和npx) - Claude Desktop 应用
安装教程
全局安装（推荐）
```bash
使用 npm 全局安装
npm install -g mcp-deepwebresearch
或使用 yarn
yarn global add mcp-deepwebresearch
或使用 pnpm
pnpm add -g mcp-deepwebresearch
```
本地项目安装
```bash
使用 npm
npm install mcp-deepwebresearch
使用 yarn
yarn add mcp-deepwebresearch
使用 pnpm
pnpm add mcp-deepwebresearch
```
Claude Desktop 集成
在安装包后，将以下条目添加到 claude_desktop_config.json 中：
Windows
json
{
"mcpServers": {
"deepwebresearch": {
"command": "mcp-deepwebresearch",
"args": []
}
}
}
位置：%APPDATA%\Claude\claude_desktop_config.json
macOS
json
{
"mcpServers": {
"deepwebresearch": {
"command": "mcp-deepwebresearch",
"args": []
}
}
}
位置：~/Library/Application Support/Claude/claude_desktop_config.json
首次设置
安装后，运行以下命令安装所需的浏览器依赖项：
bash
npx playwright install chromium
调试方式
- 检查 Claude Desktop 的 MCP 日志：
```bash
# 在 macOS 上
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
# 在 Windows 上
Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -Wait
```
- 启用调试日志：
bash
export LOG_LEVEL=debug
