用途
web-researcher-mcp 是一个 MCP（Model Context Protocol）研究服务器，为 AI 助手提供真实的网络搜索、整页阅读和多来源研究能力，并确保引用来源真实可查、不虚构。它旨在解决 AI 引用来源不可靠的问题——例如链接到不存在的论文、编造 DOI、把 SEO 垃圾内容与同行评审研究同等呈现。该工具的核心思路是：不让 AI 搜索整个网络并寄希望于结果可靠，而是让用户明确指定 AI 可以搜索哪些来源，这些来源列表被称为“搜索透镜”（search lenses）。
主要能力
- 网络搜索：支持搜索整个网络，或通过搜索透镜限定到用户信任的站点。
- 整页阅读：分析完整来源内容，而非仅依赖摘要片段。
- 多来源研究：支持多步骤研究流程，从用户指定的来源中获取信息。
- 引用核验：确保引用来源真实可查，不虚构。
- 学术搜索：可选配置 OpenAlex、CrossRef 等学术搜索提供方，返回带 DOI、作者、引用次数和开放获取 PDF 链接的真实论文。
- 专利搜索：可选配置 EPO、USPTO、The Lens 等专利提供方，返回结构化专利数据，包括分类代码、日期和发明人。
- 搜索透镜：内置多个领域的透镜，也可创建自定义透镜，限定 AI 只搜索指定域名。
- 多提供方故障转移：可配置多个搜索提供方，一个不可用时自动切换到另一个。
- 研究模板：提供引导式提示模板，帮助 AI 助手按多步骤流程完成研究。
- 状态与诊断资源：暴露实时状态资源（如 stats://tools、stats://sessions、stats://rate-limits、stats://providers）、透镜目录（lenses://catalog）、诊断信息（diagnostics://errors/recent、diagnostics://health）和大负载工件存储（research://artifact/{id}）。
使用方式
安装
- Python 用户（uvx）：
uvx web-researcher-mcp，无需编译，任何操作系统均可。也支持uv tool install web-researcher-mcp或pip install web-researcher-mcp。 - Homebrew（macOS / Linux）：
brew install zoharbabin/tap/web-researcher-mcp。 - 一键安装（任意 OS）：下载二进制文件、验证 SHA-256 校验和、加入 PATH，并在检测到 Claude Code 时自动注册。
- Windows：支持 WinGet、Scoop、Chocolatey。
- macOS Cask：提供 Developer ID 签名并公证的二进制文件。
- Go install：
go install方式安装。 - 从源码构建：支持从源码构建。
- AUR（Arch Linux）：支持 AUR 安装。
- NixOS：提供 Nix flake 模块。
连接 AI 助手
安装脚本会自动注册到 Claude Code。其他应用需在 AI 的配置文件中添加 MCP 配置。支持 Claude、Claude Desktop、Cursor 以及任何支持工具使用的 AI 助手。
搜索提供方配置
- 无需 API 密钥：DuckDuckGo 是内置的零配置回退方案，安装即可使用。
- 可选提供方：设置
SEARCH_PROVIDER=<name>并提供对应密钥。所有提供方均支持搜索透镜，可组合使用实现自动故障转移。 - 未设置
SEARCH_PROVIDER时，若存在 Google 密钥则使用 Google，否则回退到 DuckDuckGo。 - 学术搜索提供方（OpenAlex、CrossRef）接受联系邮箱以解锁更快的访问，无需注册。
- 专利搜索提供方（EPO、USPTO、The Lens）需要 API 密钥。
搜索透镜
- 内置透镜覆盖多个领域。
- 可创建自定义透镜：创建目录，为每个透镜添加 JSON 文件，然后通过配置指向该目录。自定义透镜在内置透镜之后加载，同名自定义透镜会覆盖内置透镜。每个透镜最多可添加约 10 个域名。
- 高级选项：
cx（Google Programmable Search Engine ID，最多 5,000 个域名）、routing（强制该透镜使用特定搜索提供方）。
HTTP 模式
支持团队共享实例，连接任意 AI 应用到 http://localhost:3000/mcp/。工具行为在 STDIO 和 HTTP 模式下一致，区别在于认证（HTTP 需要 OAuth）和速率限制（HTTP 按租户限制；STDIO 仅受上游 API 配额限制）。
适用场景
- 学术研究人员：需要带真实 DOI 的文献综述，而非编造的引用。
- 商业分析师：交付物需要客户可以点击并验证的来源。
- 律师：引用不存在的案例可能导致高额罚款。
- 记者：需要交叉核对政府记录和法院文件，而非依赖摘要。
- 医学研究人员：临床决策不能基于健康博客。
- 研究生：避免花费数小时追踪 AI 编造的引用。
- 企业团队：竞争研究不能经过第三方服务器。
限制
- 部分工具需要特定提供方或配置才能使用：
citation_graph和research_panel需要至少一个已配置的后备提供方；filing_search需要EDGAR_CONTACT_EMAIL；local_search需要BRAVE_API_KEY。 - 操作员可启用需用户同意的可选工具（如按用户分析、长期记忆、共享工作区、保存查询监控），这些工具仅在功能开启时出现。
- 学术搜索和专利搜索在未配置提供方时仍可使用，但会回退到网络搜索。
- 图像搜索和新闻搜索需要 API 密钥。
- 对于重度 JavaScript 站点，工具会在后台使用真实浏览器（Chromium），二进制安装时首次使用会自动下载（约 200MB）。
- 服务器在缺少凭据时仍会启动（以允许 MCP 握手），API 密钥需在 MCP 客户端配置的 env 块中设置，而非 shell 配置文件。
隐私与安全
- 研究查询直接从用户机器发送到所选搜索提供方，不经过第三方服务器。
- 提供 SSRF 防护、OAuth 2.1（HTTP 模式）、速率限制（HTTP 模式）和内容净化。
- 完整威胁模型见 docs/SECURITY.md。
