G-Search-MCP：免费谷歌搜索的MCP服务器

综合介绍

G-Search-MCP 是一个开源的谷歌搜索工具，托管在 GitHub 上，由开发者 jae-jae 基于 google-search 修改而来。它通过 MCP（Model Context Protocol）服务器运行，核心功能是支持多个关键词同时在谷歌上搜索。搜索结果以 JSON 格式返回，方便用户处理和分析。这个工具使用 Playwright 浏览器模拟真实用户操作，能有效降低被谷歌屏蔽的风险。它适合需要快速获取大量信息的用户，比如开发者、研究人员或数据分析师。项目还提供灵活的参数配置，例如结果数量和语言选择。

功能列表

• 多关键词并行搜索：支持同时搜索多个关键词，提升效率。
• 浏览器优化：在单个浏览器实例中打开多个标签页，节省资源。
• 验证码自动检测：发现验证码时切换到可见模式，等待用户验证。
• 用户行为模拟：模仿真实用户操作，避免被搜索引擎限制。
• JSON 数据输出：搜索结果以结构化格式返回，方便程序使用。
• 参数调整：可设置结果数量、超时时间、语言区域等选项。

使用帮助

G-Search-MCP 是一个技术性工具，需要安装和配置才能使用。下面详细介绍安装流程和操作方法。

安装流程

1. 检查环境要求
   • 需要 Node.js 18 或更高版本，已安装 NPM 或 Yarn。
   • 确保电脑有 Git，用于下载代码。
   • 准备一个现代浏览器（如 Chromium），工具会自动安装。
2. 下载项目代码
   • 打开终端，运行命令：

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

   • 进入项目目录：

     cd g-search-mcp
     

3. 安装依赖
   • 输入命令安装必要包：

     npm install
     

4. 安装 Playwright 浏览器
   • 运行以下命令安装 Chromium 浏览器：

     npx playwright install chromium
     

   • 这步确保工具能正常运行浏览器实例。
5. 构建服务器
   • 输入命令构建项目：

     npm run build
     

6. 快速启动
   • 使用命令直接运行：

     npx -y g-search-mcp
     

   • 服务器启动后即可使用。

配置 MCP 服务器（可选）

如果想在 Claude Desktop 中使用这个工具，可以配置 MCP 服务器：

• 配置文件路径
  • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%/Claude/claude_desktop_config.json
• 配置内容
  • 编辑 JSON 文件，添加以下内容：

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

如何使用

基本操作

1. 单关键词搜索
   • 运行命令：

     npx -y g-search-mcp --keywords "人工智能"
     

   • 浏览器打开一个标签页显示结果，终端返回 JSON 数据。
2. 多关键词搜索
   • 输入多个关键词，用逗号分隔：

     npx -y g-search-mcp --keywords "人工智能,机器学习"
     

   • 浏览器会打开多个标签页，每个关键词对应一个。

特色功能操作

1. 调整结果数量
   • 使用 --limit 参数：

     npx -y g-search-mcp --keywords "人工智能" --limit 20
     

   • 返回前 20 条结果，默认是 10 条。
2. 设置超时时间
   • 使用 --timeout 参数：

     npx -y g-search-mcp --keywords "人工智能" --timeout 120000
     

   • 将超时设为 120 秒，默认是 60 秒。
3. 更改语言区域
   • 使用 --locale 参数：

     npx -y g-search-mcp --keywords "人工智能" --locale "zh-CN"
     

   • 结果优先显示中文。
4. 启用调试模式
   • 添加 --debug 参数：

     npx -y g-search-mcp --keywords "人工智能" --debug
     

   • 浏览器窗口可见，方便查看操作过程。
5. 验证码处理
   • 如果遇到验证码，工具会暂停并显示浏览器窗口。
   • 用户手动完成验证后，工具继续运行。
6. 查看 JSON 输出
   • 搜索完成后，终端显示类似以下结果：

     {
     "searches": [
     {
     "query": "人工智能",
     "results": [
     {
     "title": "人工智能简介",
     "link": "https://example.com",
     "snippet": "人工智能是..."
     }
     ]
     }
     ]
     }
     

   • 可保存结果到文件：

     npx -y g-search-mcp --keywords "人工智能" > result.json
     

开发模式（可选）

• 自动重建：运行 npm run watch，代码修改后自动更新。
• 调试工具：运行 npm run inspector，使用 MCP Inspector 检查运行状态。

注意事项

• 网络连接：必须联网访问谷歌服务。
• 资源占用：多关键词搜索可能消耗较多内存。
• 权限问题：确保终端有足够权限运行命令。

操作示例

假设你要搜索“区块链”和“智能合约”：

1. 输入命令：

npx -y g-search-mcp --keywords "区块链,智能合约" --limit 15 --locale "zh-CN"

2. 浏览器打开两个标签页，显示中文搜索结果。
3. 终端返回 JSON 数据，包含每条结果的标题、链接和摘要。

这个工具操作直观，功能强大，适合技术用户批量收集信息。

应用场景

1. 技术研究
   开发者可以用它搜索“前端框架”“后端技术”等关键词，快速对比资料。
2. 数据分析
   分析师可以用 JSON 输出分析“市场趋势”“用户需求”等关键词结果。
3. 教育支持
   学生可以用它搜索“物理学”“化学反应”，快速获取学习资源。

QA

1. 启动时提示缺少 Playwright 怎么办？
   运行 npx playwright install chromium 安装浏览器。
2. 搜索结果不完整怎么办？
   检查网络，或增加 --timeout 时间，比如 120000 毫秒。
3. 如何保存搜索结果？
   在命令后加 > 文件名.json，例如 npx -y g-search-mcp --keywords "人工智能" > result.json。