使用说明

项目简介

MCP Deep Web Research Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型 (LLM) 客户端提供强大的网络研究能力。通过集成智能搜索队列、增强内容提取和深度研究功能，该服务器能够帮助 LLM 客户端从网络获取实时信息，并进行深入分析。

主要功能点

智能搜索队列系统: 批量处理搜索请求，具备速率限制、队列管理、进度跟踪、错误恢复和结果去重等功能。
增强内容提取: 利用 TF-IDF、关键词邻近度分析、可读性评分等技术，提升网页内容的提取质量和相关性。
核心功能: 集成 Google 搜索、网页内容提取、研究会话跟踪、Markdown 转换等核心网络研究功能。
工具 (Tools): 提供 'deep_research' (深度研究)、'parallel_search' (并行搜索)、'visit_page' (访问网页) 等工具，供 LLM 客户端调用。
Prompt 模板 (Prompts): 提供 'agentic-research' Prompt 模板，支持用户进行引导式、交互式的网络研究。

安装步骤

确保已安装 Node.js (>= 18)。

全局安装 'mcp-deepwebresearch' 包 (推荐):

npm install -g mcp-deepwebresearch

或使用 yarn:

yarn global add mcp-deepwebresearch

或使用 pnpm:

pnpm add -g mcp-deepwebresearch

首次安装后，运行以下命令安装浏览器依赖:

npx playwright install chromium

服务器配置

要将 MCP Deep Web Research Server 集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的配置文件。以下是针对 Claude Desktop 的配置示例，添加到 'claude_desktop_config.json' 文件中：

{
  "mcpServers": {
    "deepwebresearch": {
      "command": "mcp-deepwebresearch",
      "args": []
    }
  }
}

'server name': 'deepwebresearch' (服务器名称，用于在客户端中标识和调用)
'command': 'mcp-deepwebresearch' (启动 MCP 服务器的命令)
'args': '[]' (启动命令参数，本服务器无需额外参数)

根据您的操作系统，'claude_desktop_config.json' 文件可能位于不同的路径：

Windows: '%APPDATA%\Claude\claude_desktop_config.json'
macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'

基本使用方法

启动 Claude 等 MCP 客户端。
在客户端的集成配置中启用 'deepwebresearch' 服务器。
在聊天界面中，您可以：
- 使用 'deep_research' 工具进行深度网络研究，例如提问 "使用 deep_research 工具，研究量子计算的应用前景"。
- 使用 'parallel_search' 工具进行并行搜索，例如提问 "使用 parallel_search 工具，搜索 '量子计算的优势' 和 '量子计算的挑战'"。
- 使用 'visit_page' 工具访问特定网页并提取内容，例如提问 "使用 visit_page 工具，访问 'https://example.com' 并提取内容"。
- 使用 'agentic-research' Prompt 模板进行引导式研究，在客户端选择集成 -> deepwebresearch -> agentic-research，然后输入研究主题。

关键词