全局搜索-MCP

Name: 全局搜索-MCP
Author: jae-jae

作者：jae-jae227 星标更新：2025-06-14

项目介绍

G-Search MCP

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

该项目基于google-search修改。

🌟 推荐: OllaMan - 强大的Ollama AI模型管理器。

优势

并行搜索: 支持在Google上同时使用多个关键词进行搜索，提高搜索效率
浏览器优化: 在单个浏览器实例中打开多个标签页以实现高效的并行搜索
自动验证处理: 智能检测验证码，并在需要时启用可见浏览器模式供用户验证
模拟用户行为: 模拟真实用户的浏览模式，减少被搜索引擎检测的可能性
结构化数据: 返回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": "机器学习",
      "results": [
        {
          "title": "什么是机器学习？| IBM",
          "link": "https://www.ibm.com/topics/machine-learning",
          "snippet": "机器学习是人工智能（AI）和计算机科学的一个分支，专注于利用数据和算法模仿人类的学习方式，逐步提高其准确性。"
        },
        ...
      ]
    },
    {
      "query": "人工智能",
      "results": [
        {
          "title": "什么是人工智能（AI）？| IBM",
          "link": "https://www.ibm.com/topics/artificial-intelligence",
          "snippet": "人工智能利用计算机和机器模仿人类思维的问题解决和决策能力。"
        },
        ...
      ]
    }
  ]
}

使用提示

处理特殊网站场景

调整搜索参数

搜索结果数量: 获取更多搜索结果：
```
请返回每个关键词的前20条搜索结果
```
这将设置limit: 20参数。
增加超时时间: 对于加载缓慢的情况：
```
请将页面加载超时时间设置为120秒
```
这将调整timeout参数为120000毫秒。

区域设置调整

更改搜索地区: 指定不同的语言设置：
```
请使用中文地区（zh-CN）进行搜索
```
这将设置locale: "zh-CN"参数。

调试与故障排除

启用调试模式

动态调试激活: 在特定搜索操作期间显示浏览器窗口：
```
请为此搜索操作启用调试模式
```
即使服务器没有使用--debug标志启动，这也会设置debug: true。

安装

先决条件

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

从源代码安装

克隆仓库：

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

安装依赖项：

npm install

安装Playwright浏览器：

npm run install-browser

构建服务器：

npm run build

开发

自动重建（开发模式）

npm run watch

使用MCP Inspector进行调试

npm run inspector

许可证

根据MIT许可证授权。