项目简介

G-Search MCP 是一个强大的 MCP 服务器,专为 Google 搜索设计。它允许用户通过 MCP 协议以标准化的方式进行 Google 搜索,并能同时使用多个关键词进行并行搜索,极大地提高了信息检索效率。

主要功能点

  • 并行 Google 搜索:支持同时使用多个关键词在 Google 上进行搜索,提升搜索效率。
  • 结构化搜索结果:返回 JSON 格式的结构化搜索结果,方便后续处理和分析。
  • 自动 CAPTCHA 处理:智能检测 CAPTCHA 验证,并在必要时启用可见浏览器模式进行用户验证。
  • 可配置参数:支持多种参数配置,例如搜索结果数量限制、超时设置和地区设置等。
  • MCP 协议标准:遵循 Model Context Protocol (MCP) 协议,可与任何兼容 MCP 协议的客户端配合使用。

安装步骤

  1. 前置条件:确保已安装 Node.js 18 或更高版本,以及 NPM 或 Yarn 包管理器。
  2. 克隆仓库
    git clone https://github.com/jae-jae/g-search-mcp.git
    cd g-search-mcp
  3. 安装依赖
    npm install
  4. 安装 Playwright 浏览器
    npm run install-browser
  5. 构建服务器
    npm run build

服务器配置

要将 G-Search MCP 服务器与 MCP 客户端(例如 Claude Desktop)配合使用,您需要在客户端中配置 MCP 服务器的启动命令。以下是 Claude Desktop 的配置示例:

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

配置参数说明:

  • 'mcpServers': 定义可用的 MCP 服务器列表。
  • 'g-search': 为该 Google 搜索 MCP 服务器自定义的名称,客户端通过此名称引用该服务器。
  • 'command': 启动服务器的命令,这里使用 'npx',它可以直接运行本地安装或临时下载的 'g-search-mcp' 包。
  • 'args': 传递给启动命令的参数,'-y' 参数用于 'npx' 自动确认安装,'g-search-mcp' 是要执行的包名。

注意: 请将以上 JSON 配置添加到您的 MCP 客户端的配置文件中。具体的配置文件位置请参考您的 MCP 客户端文档。

基本使用方法

配置完成后,MCP 客户端即可通过 'g-search' 这个服务器名称来调用 'search' 工具进行 Google 搜索。

例如,在 Claude Desktop 中,您可以指示 Claude 使用 'search' 工具进行搜索,例如:

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

服务器将返回 JSON 格式的搜索结果,客户端可以解析并展示这些结果。

工具 'search' 支持以下参数,您可以在客户端请求中根据需要进行配置:

  • 'queries': (必填) 搜索关键词数组,例如 '["机器学习", "人工智能"]'。
  • 'limit': (可选) 每个关键词返回的最大结果数,默认为 10。
  • 'timeout': (可选) 页面加载超时时间,单位毫秒,默认为 60000 (60秒)。
  • 'locale': (可选) 搜索结果的地区设置,默认为 'en-US' (美国英语)。
  • 'debug': (可选) 是否启用调试模式,启用后会显示浏览器窗口,默认为 'false'。

您可以通过自然语言指令或客户端提供的参数配置界面来设置这些参数。

信息

分类

网页与API