MCP Web Research Server

一个用于网络研究的模型上下文协议 (MCP) 服务器。

将实时信息带入 Claude，轻松研究任何主题。

功能

• Google 搜索集成 --- 此 FORK 修复了此问题 --- 现在不再被 CAPTCHA 阻止
• 网页内容提取
• 研究会话跟踪（已访问页面列表、搜索查询等）
• 屏幕截图捕获

前提条件

• Node.js >= 18（包括 npm 和 npx）
• Claude 桌面应用程序

安装

首先，请确保您已下载并安装了 Claude 桌面应用程序 并且您已安装 npm。

接下来，将以下条目添加到您的 claude_desktop_config.json 中（在 Mac 上，位于 ~/Library/Application\ Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "webresearch": {
      "command": "npx",
      "args": ["-y", "@mzxrai/mcp-webresearch@latest"]
    }
  }
}

此配置允许 Claude 桌面应用程序在需要时自动启动 Web Research MCP 服务器。

用法

只需与 Claude 开始聊天，并发送一个可以从网络研究中受益的提示。 如果您想要一个为更深入的网络研究定制的预构建提示，您可以使用我们通过此软件包提供的 agentic-research 提示。 通过单击聊天输入中的回形针图标，然后选择 Choose an integration → webresearch → agentic-research，在 Claude 桌面应用程序中访问该提示。

<img src="https://i.ibb.co/N6Y3C0q/Screenshot-2024-12-05-at-11-01-27-PM.png" alt="Example screenshot of web research" width="400"/>

工具

1. search_google

   • 执行 Google 搜索并提取结果
   • 参数：{ query: string }

2. visit_page

   • 访问网页并提取其内容
   • 参数：{ url: string, takeScreenshot?: boolean }

3. take_screenshot

   • 拍摄当前页面的屏幕截图
   • 无需参数

提示

agentic-research

一个引导式研究提示，可帮助 Claude 进行彻底的网络研究。 该提示指示 Claude：

• 从广泛的搜索开始，以了解主题概况
• 优先考虑高质量、权威的来源
• 根据发现迭代地改进研究方向
• 随时通知您并让您以交互方式指导研究
• 始终引用带有 URL 的来源

资源

我们将两件事作为 MCP 资源公开：（1）捕获的网页屏幕截图，以及（2）研究会话。

屏幕截图

当您拍摄屏幕截图时，它会保存为 MCP 资源。 您可以通过 Claude 桌面应用程序中的回形针图标访问捕获的屏幕截图。

研究会话

服务器维护一个研究会话，其中包括：

• 搜索查询
• 已访问的页面
• 提取的内容
• 屏幕截图
• 时间戳

建议

为了获得最佳结果，如果您在进行研究时选择不使用 agentic-research 提示，建议 Claude 在研究一般主题时使用高质量的来源可能会有所帮助。 例如，您可以提示 news today from reuters or AP 而不是 news today。

问题

这在很大程度上是 pre-alpha 代码。 而且它也是 AIGC，所以请期待错误。

如果您遇到问题，检查 Claude 桌面应用程序的 MCP 日志可能会有所帮助：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

开发

# 安装依赖项
pnpm install

# 构建项目
pnpm build

# 监视更改
pnpm watch

# 在开发模式下运行
pnpm dev

要求

• Node.js >= 18
• Playwright（作为依赖项自动安装）

验证平台

• [x] macOS
• [x] Linux
• [x] Windows

许可证

MIT

作者

mzxrai