🚀 G-Search MCP

G-Search MCP是一个强大的MCP服务器，专为Google搜索打造，支持使用多个关键词同时进行并行搜索，极大提升了搜索效率。

该项目基于google-search进行修改。

🚀 快速开始

直接运行

直接使用npx运行：

npx -y g-search-mcp

首次安装时，请先在终端中执行以下命令以安装所需的浏览器：

npx playwright install chromium

调试模式

使用--debug选项以调试模式运行（显示浏览器窗口）：

npx -y g-search-mcp --debug

✨ 主要特性

• 并行搜索：支持同时使用多个关键词在Google上搜索，提高搜索效率。
• 浏览器优化：在一个浏览器实例中打开多个标签页以实现高效并行搜索。
• 自动验证处理：智能检测CAPTCHA，并在需要时启用可见浏览器模式以便用户进行验证。
• 用户行为模拟：模拟真实用户的浏览习惯，降低被搜索引擎检测的风险。
• 结构化数据返回：以JSON格式返回结构化的搜索结果，便于后续处理和分析。
• 可配置参数：支持多种参数配置，例如搜索结果限制、超时设置、地区设置等。

📦 安装指南

1. 克隆仓库：

git clone https://github.com/jae-jae/g-search-mcp.git
cd g-search-mcp

2. 安装依赖项：

npm install

3. 安装Playwright浏览器：

npm run install-browser

4. 构建服务器：

npm run build

💻 使用示例

基础用法

执行并行搜索：

g-search-mcp search --queries keyword1,keyword2 --limit 5

高级用法

获取实时汇率数据：

g-search-mcp fetcher --url https://www.google.com/finance/markets/currencies/EURUSD=X --xpath //*[@class=' financial-data-bucket__value']

返回结果

搜索结果将以JSON格式返回，示例如下：

{
  "results": [
    {
      "title": "关键词1的相关内容",
      "url": "https://example.com/keyword1",
      "snippet": "关键词1的简要描述..."
    },
    {
      "title": "关键词2的相关内容",
      "url": "https://example.com/keyword2",
      "snippet": "关键词2的简要描述..."
    }
  ]
}

📚 详细文档

配置MCP

在Claude Desktop中配置此MCP服务器： MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "g-search": {
      "command": "npx",
      "args": ["-y", "g-search-mcp"]
    }
  }
}

功能特性说明

• search - 执行Google搜索，支持多个关键词并返回结果
  • 使用Playwright浏览器进行搜索操作
  • 支持以下参数：
    • queries：要执行的搜索查询数组（必填参数）
    • limit：每个查询的最大返回结果数，默认为10
    • timeout：页面加载超时时间（以毫秒为单位），默认60000（60秒）
    • noSaveState：是否避免保存浏览器状态，默认为false
    • proxy：代理设置，支持HTTP、HTTPS和SOCKS协议
    • region：指定搜索区域（如"us"表示美国）

使用技巧

• 处理特殊网站场景：通过自定义脚本实现对特定网页内容的提取和处理。
• 调试与故障排除：
  • 检查浏览器驱动是否正确安装并保持最新。
  • 确保网络连接稳定，避免因超时导致搜索失败。
  • 定期清理缓存以提高搜索效率。

开发相关

自动重建（开发模式）

npm run watch

使用MCP Inspector进行调试

npm run inspector

🔗 相关项目

• fetcher-mcp：一个强大的MCP服务器，用于使用Playwright无头浏览器抓取网页内容。特点包括智能内容提取、并行处理、资源优化等，是网络爬虫的理想选择。

📄 许可证

本项目 licensed under the MIT License