Google 搜索 MCP

用于谷歌搜索的模型上下文协议服务器。一款基于 Playwright 的模型上下文协议 (MCP) 工具，可绕过搜索引擎反机器人机制，执行谷歌搜索并提取结果，为 Claude 和 Cursor 等人工智能助手提供实时搜索功能。

特征

• 反机器人绕过：使用浏览器指纹欺骗和真实用户行为模拟来避免检测

• 自动验证码处理：遇到验证码时切换到头模式，允许用户完成验证

• 状态持久性：保存浏览器会话状态，以减少重复验证的需要

• 适应性：使用多种选择器组合来适应 Google 搜索页面的变化

• MCP 集成：实现模型上下文协议，以便轻松与 AI 助手集成

• 多语言支持：支持不同语言和地区的搜索结果

Related MCP server: Playread

与游标一起使用

安装 - 全球

使用 npx 运行 MCP 服务器：

npx -y @mcp-server/google-search-mcp@latest

在你的 Cursor IDE 中

1. 前往Cursor Settings > MCP

2. 点击+ Add New MCP Server

3. 填写表格：

   • 名称： google-search （或您喜欢的任何名称）

   • 类型： command

   • 命令： npx -y @mcp-server/google-search-mcp@latest

安装 - 特定于项目

将.cursor/mcp.json文件添加到您的项目：

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-server/google-search-mcp@latest"
      ]
    }
  }
}

发展

yarn install

构建项目

yarn build

用法

作为 MCP 服务器运行

yarn start

与 MCP Inspector 一起使用

要调试服务器，您可以使用MCP 检查器：

# First build the project
yarn build

# Start the MCP Inspector and server
npx @modelcontextprotocol/inspector node dist/index.js

参数

搜索工具接受以下参数：

• query （必需）：搜索查询字符串

• limit （可选）：返回的搜索结果数量，默认为 10

• timeout （可选）：搜索操作超时（以毫秒为单位），默认值为 60000

• language （可选）：搜索结果的语言，例如 zh-CN、en-US，默认为 zh-CN

• region （可选）：搜索结果的地区，例如 cn、com、co.jp，默认为 cn

工作原理

1. 该工具使用 Playwright 控制 Chromium 浏览器执行 Google 搜索

2. 它通过浏览器指纹欺骗和真实用户行为模拟来避免机器人检测

3. 遇到CAPTCHA验证时，自动切换到头显模式供用户完成

4. 它提取搜索结果并以结构化格式返回

5. 它保存浏览器状态以便在后续搜索中重复使用

高级配置

浏览器状态文件

默认情况下，浏览器状态保存在用户主目录下的.google-search-browser-state.json文件中。您可以通过参数修改此路径。

语言和区域设置

您可以通过参数指定搜索结果的语言和地区：

// English (US) search results
"language": "en-US", "region": "com"

// Japanese search results
"language": "ja-JP", "region": "co.jp"

// Chinese (Simplified) search results
"language": "zh-CN", "region": "cn"

笔记

• 首次使用时，如遇到CAPTCHA验证，系统将自动切换至头显模式，以便您完成验证

• 验证后系统会保存状态文件，使后续搜索更加顺畅

• 过于频繁的搜索请求可能会触发 Google 的速率限制机制

• 本工具仅供学习研究之用，请遵守Google的服务条款

执照

麻省理工学院

免责声明

本工具仅供学习研究之用。使用本工具访问谷歌或其他搜索引擎时，请遵守相关服务条款及相关法律法规。作者对因使用本工具而产生的任何问题概不负责。