金大哥 - g-search-mcp MCP 详情

article

README

🚀 G-Search MCP

G-Search MCP 是一个强大的 MCP 服务器，专为 Google 搜索而设计。它支持同时使用多个关键词进行并行搜索，极大地提高了搜索效率，为用户带来更高效的搜索体验。

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

✨ 主要特性

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

🚀 快速开始

直接运行

直接使用 npx 运行：

npx -y g-search-mcp

安装浏览器

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

npx playwright install chromium

调试模式

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

npx -y g-search-mcp --debug

📦 安装指南

克隆仓库：

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

💻 使用示例

基础用法

执行并行搜索：

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

📄 许可证

本项目 licensed under the MIT License

g-search-mcp