金大哥 - mcp-webresearch MCP 详情

article

README

🚀 MCP 网络研究服务器

MCP 网络研究服务器是专为网络研究设计的模型上下文协议（MCP）服务器。它能将实时信息引入 Claude，让你轻松开展任何主题的研究。

🚀 快速开始

MCP 网络研究服务器可将实时信息融入 Claude，助力你进行各类主题的研究。只需确保满足先决条件，完成安装步骤，即可开启网络研究之旅。

✨ 主要特性

🔍 Google 搜索集成：可直接在服务器中使用 Google 搜索。
📃 网页内容提取：能提取网页中的关键内容。
📋 研究会话跟踪：记录访问过的页面列表、搜索查询等信息。
📸 截图捕获：可对当前页面进行截图。

📦 安装指南

先决条件

Node.js >= 18（包含 npm 和 npx）
已安装 Claude Desktop 应用

安装步骤

首先，要确保已下载并安装 Claude Desktop 应用，同时安装了 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 Desktop 在需要时自动启动网络研究 MCP 服务器。

💻 使用示例

基础用法

只需开启与 Claude 的对话，并发送一个适合网络研究的提示。若想使用本包中定制的深层网络研究提示，可在 Claude Desktop 中点击聊天输入框的纸clip图标，然后选择 Choose an integration → webresearch → agentic-research。

工具使用

`search_google`

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

`visit_page`

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

`take_screenshot`

功能：捕获当前页面的截图
参数：无需任何参数

提示语使用

`agentic-research`

这是一个指导性研究提示，可帮助 Claude 进行全面的网络研究。该提示会指导 Claude：

先进行广泛搜索，了解主题背景。
优先选用高质量、权威的来源。
根据发现结果逐步优化研究方向。
与你保持互动，让你指导研究。
始终引用带有 URL 的来源。

资源访问

截图

当你捕获截图时，它会被保存为 MCP 资源。你可以在 Claude Desktop 中通过纸clip图标访问捕获的截图。

研究会话

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

搜索查询
访问过的页面
提取的内容
截图
时间戳

📚 详细文档

建议

为获得最佳效果，若你不使用 agentic-research 提示进行研究，可建议 Claude 在研究通用主题时使用高质量来源。例如，你可以提示 新闻来自路透社或美联社 而非 今日新闻。

问题处理

此代码处于预发布阶段，且由 AIGC 生成，可能存在错误。

若你遇到问题，检查 Claude Desktop 的 MCP 日志可能会有帮助：

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

开发

# 下载依赖项
npm install

# 启动开发服务器
npm run dev

贡献指南

欢迎贡献代码！请查看 CONTRIBUTING.md 以获取更多信息。

📄 许可证

[此处插入许可证信息，例如 MIT 许可证]

📞 联系方式

GitHub: [你的 GitHub 链接]
Email: [你的电子邮件地址]

mcp-webresearch