google-search-mcp

Google Search MCP

用于 Google 搜索的模型上下文协议服务。 这是一款基于 Playwright 的模型上下文协议（MCP）工具，可绕过搜索引擎的反机器人机制、执行 Google 搜索并提取结果，为 Claude 和 Cursor 等 AI 助手提供实时搜索能力。

功能

• 绕过反机器人检测：使用浏览器指纹伪装和真实用户行为模拟来避免被检测
• 自动处理 CAPTCHA：遇到 CAPTCHA 时切换到有头模式，让用户完成验证
• 状态持久化：保存浏览器会话状态，减少重复验证的需要
• 适应性：使用多种选择器组合来适应 Google 搜索页面的变化
• MCP 集成：实现模型上下文协议，便于与 AI 助手集成
• 多语言支持：支持不同语言和地区的搜索结果

与 Cursor 搭配使用

全局安装

使用 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 Inspector：

# 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 的服务条款

许可证

MIT

免责声明

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