README
🚀 网络研究 MCP 服务器
本项目是一个用于网络研究的模型上下文协议(MCP)服务器,它能将实时信息引入Claude,让用户轻松开展任何主题的网络研究。
🚀 快速开始
本服务器可助力Claude获取实时网络信息,开展各类主题的研究。您只需开启与Claude的对话,并发送适合网络研究的提示,即可借助服务器完成研究。
✨ 主要特性
- Google搜索集成:可执行Google搜索并提取结果。
- 网页内容提取:能够访问网页并提取其内容。
- 研究会话跟踪:记录访问过的页面、搜索查询等信息。
- 截图捕获:可捕获当前页面的截图。
📦 安装指南
先决条件
- 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 桌面应用程序在需要时自动启动网络研究 MCP 服务器。
💻 使用示例
基础用法
简单地开始与Claude的聊天,并发送一个可以受益于网络研究的提示。如果您想使用我们提供的这个包中的深度网络研究预建提示,可以通过点击Claude桌面中的纸clip图标,然后选择 Choose an integration → webresearch → agentic-research 来访问该提示。
高级用法
工具使用
search_google- 执行 Google 搜索并提取结果
- 参数:
{ query: string }
visit_page- 访问网页并提取其内容
- 参数:
{ url: string, takeScreenshot?: boolean }
take_screenshot- 捕获当前页面的截图
- 无需参数
提示语使用
agentic-research
一个引导性研究提示,帮助Claude进行彻底的网络研究。该提示指示Claude:
- 从广泛搜索开始以了解主题背景
- 优先考虑高质量、权威来源
- 基于发现结果逐步 refining 研究方向
- 主动通知并让您互动指导研究
- 总是引用带有 URL 的来源
📚 详细文档
资源说明
我们通过 MCP 资源暴露两件事:(1) 捕获的网页截图,(2) 研究会话。
截图
当您捕获截图时,它作为 MCP 资源保存。您可以通过Claude桌面中的纸clip图标访问捕获的截图。
研究会话
服务器维护一个研究会话,包括:
- 搜索查询
- 访问过的页面
- 提取的内容
- 截图
- 时间戳
建议
为了获得最佳效果,如果您选择不使用 agentic-research 提示进行研究,建议提示Claude在研究通用主题时使用高质量来源。例如,您可以提示Claude:“请从以下来源中引用:[指定的高质量来源列表]”。
注意事项和问题处理
- 如果遇到问题,请检查服务器日志以获取更多信息。
- 检查和解决问题的详细步骤可以参考 问题排查指南。
开发相关
安装依赖
npm install @mzxrai/mcp-webresearch@latest
构建项目
npm run build
运行服务器
npm start
📄 许可证
[此处插入许可证信息]
👨💻 作者
[此处插入作者信息]
Scan to contact