用途
g-search-mcp 是一个面向 Google 搜索的 MCP(Model Context Protocol)服务器,主要解决需要同时用多个关键词进行搜索的场景。它允许一次提交多个查询词,并行执行搜索,从而提升搜索效率。该项目由 google-search 修改而来。
主要能力
- 并行搜索:支持在 Google 上同时使用多个关键词进行搜索,提高搜索效率。
- 浏览器优化:在单个浏览器实例中打开多个标签页,实现高效的并行搜索。
- 自动验证处理:智能检测 CAPTCHA(验证码),在需要时启用可见浏览器模式供用户完成验证。
- 用户行为模拟:模拟真实用户的浏览模式,降低被搜索引擎检测的可能性。
- 结构化数据:以 JSON 格式返回结构化的搜索结果,便于处理和分析。
- 可配置参数:支持搜索结果数量上限、超时设置、区域语言设置等多种参数配置。
使用方式
通过 npx 直接运行
首次设置时,需在终端中运行命令安装所需的浏览器。
可使用 --debug 选项以调试模式运行(显示浏览器窗口)。
在 Claude Desktop 中配置
配置文件位置:
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
search 工具
执行多关键词 Google 搜索并返回结果,使用 Playwright 浏览器进行搜索。支持以下参数:
queries:要执行的搜索查询数组(必填参数)limit:每个查询返回的最大结果数,默认 10timeout:页面加载超时时间(毫秒),默认 60000(60 秒)noSaveState:是否避免保存浏览器状态,默认 falselocale:搜索结果的语言区域设置,默认 en-USdebug:是否启用调试模式(显示浏览器窗口),会覆盖命令行中的--debug标志
参数调整示例
- 增加搜索结果数量:例如要求“每个关键词返回前 20 条搜索结果”,将设置
limit: 20参数。 - 增加超时时间:针对加载缓慢的情况,例如“将页面加载超时设置为 120 秒”,将把
timeout参数调整为 120000 毫秒。 - 更改搜索区域:指定不同的语言区域,例如“请使用中文区域(zh-CN)进行搜索”,将设置
locale: "zh-CN"参数。
调试与故障排除
- 动态启用调试:在特定搜索操作中显示浏览器窗口,例如“请为此搜索操作启用调试模式”,即使服务器启动时未加
--debug标志,也会设置debug: true。
环境要求与安装
- 需要 Node.js 18 或更高版本。
从源码安装
- 克隆仓库
- 安装依赖
- 安装 Playwright 浏览器
- 构建服务器
自动重建(开发模式)
支持开发模式下的自动重建。
使用 MCP Inspector 进行调试
可使用 MCP Inspector 进行调试。
相关项目
- fetcher-mcp:一个使用 Playwright 无头浏览器获取网页内容的 MCP 服务器,具备智能内容提取、并行处理、资源优化等特性,适合网页内容抓取。
许可
本项目基于 MIT 许可证授权。