Google Search MCP

用于 Google 搜索的 Model Context Protocol 服务器。 一个基于 Playwright 的 Model Context Protocol (MCP) 工具，可以绕过搜索引擎的反爬虫机制，执行 Google 搜索并提取结果，为 Claude 和 Cursor 等 AI 助手提供实时搜索能力。

特性

• 反爬虫绕过: 使用浏览器指纹欺骗和真实用户行为模拟来避免检测
• 自动 CAPTCHA 处理: 遇到 CAPTCHA 时切换到有头模式，允许用户完成验证
• 状态持久化: 保存浏览器会话状态，以减少重复验证的需求
• 适应性: 使用多个选择器组合来适应 Google 搜索页面的变化
• MCP 集成: 实现 Model Context Protocol，便于与 AI 助手集成
• 多语言支持: 支持不同语言和地区的搜索结果

与 Cursor 一起使用

全局安装

使用 npx 运行 MCP 服务器：

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

在您的 Cursor IDE 中

1. 进入 Cursor Settings > MCP
2. 点击 + Add New MCP Server
3. 填写表单：
   • Name: google-search (或您喜欢的任何名称)
   • Type: command
   • 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 Inspector:

# 首先构建项目
yarn build

# 启动 MCP Inspector 和服务器
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 文件中。您可以通过参数修改此路径。

语言和地区设置

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

// 英语（美国）搜索结果
"language": "en-US", "region": "com"

// 日语搜索结果
"language": "ja-JP", "region": "co.jp"

// 中文（简体）搜索结果
"language": "zh-CN", "region": "cn"

注意事项

• 首次使用时，如果遇到 CAPTCHA 验证，系统会自动切换到有头模式供您完成验证
• 验证后，系统将保存状态文件，使后续搜索更加顺畅
• 过于频繁的搜索请求可能会触发 Google 的速率限制机制
• 此工具仅用于学习和研究目的，请遵守 Google 的服务条款

许可证

MIT

免责声明

此工具仅用于学习和研究目的。使用此工具访问 Google 或其他搜索引擎时，请遵守相关服务条款和法律法规。作者不对因使用此工具而产生的任何问题负责。