<div align="center"> <img src="https://github.com/jae-jae/g-search-mcp/raw/main/icon.svg" width="120" height="120" alt="g-search-mcp Logo" /> </div>

G-Search MCP

一个强大的 Google 搜索 MCP 服务器，支持使用多个关键词同时进行并行搜索。

本项目修改自 google-search。

优势

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

快速开始

直接使用 npx 运行：

npx -y g-search-mcp

首次设置 - 通过在终端中运行以下命令来安装所需的浏览器：

npx playwright install chromium

调试模式

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

npx -y g-search-mcp --debug

配置 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
    • locale: 搜索结果的区域设置，默认为 en-US
    • debug: 是否启用调试模式（显示浏览器窗口），覆盖命令行中的 --debug 标志

使用示例:

使用搜索工具在 Google 上搜索“机器学习”和“人工智能”

示例响应:

{
  "searches": [
    {
      "query": "machine learning",
      "results": [
        {
          "title": "What is Machine Learning? | IBM",
          "link": "https://www.ibm.com/topics/machine-learning",
          "snippet": "Machine learning is a branch of artificial intelligence (AI) and computer science which focuses on the use of data and algorithms to imitate the way that humans learn, gradually improving its accuracy."
        },
        ...
      ]
    },
    {
      "query": "artificial intelligence",
      "results": [
        {
          "title": "What is Artificial Intelligence (AI)? | IBM",
          "link": "https://www.ibm.com/topics/artificial-intelligence",
          "snippet": "Artificial intelligence leverages computers and machines to mimic the problem-solving and decision-making capabilities of the human mind."
        },
        ...
      ]
    }
  ]
}

使用技巧

处理特殊网站场景

调整搜索参数

• 搜索结果数量: 获取更多搜索结果：

  请返回每个关键词的前 20 个搜索结果
  

  这将设置 limit: 20 参数。

• 增加超时时间: 对于加载缓慢的情况：

  请将页面加载超时时间设置为 120 秒
  

  这将调整 timeout 参数为 120000 毫秒。

区域设置调整

• 更改搜索区域: 指定不同的区域设置：

  请使用中文区域设置 (zh-CN) 进行搜索
  

  这将设置 locale: "zh-CN" 参数。

调试和故障排除

启用调试模式

• 动态调试激活: 在特定搜索操作期间显示浏览器窗口：

  请为此搜索操作启用调试模式
  

  即使服务器启动时没有 --debug 标志，也会设置 debug: true。

安装

前提条件

• Node.js 18 或更高版本
• NPM 或 Yarn

从源代码安装

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

开发

自动重建（开发模式）

npm run watch

使用 MCP Inspector 进行调试

npm run inspector

相关项目

• fetcher-mcp: 一个强大的 MCP 服务器，用于使用 Playwright 无头浏览器抓取网页内容。 具有智能内容提取、并行处理、资源优化等功能，使其成为网页内容抓取的理想工具。

许可证

根据 MIT 许可证 授权