Google 搜索 MCP

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

特征

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

与游标一起使用

安装 - 全球

使用 npx 运行 MCP 服务器：

在你的 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文件添加到您的项目：

发展

构建项目

用法

作为 MCP 服务器运行

与 MCP Inspector 一起使用

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

参数

搜索工具接受以下参数：

• 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文件中。您可以通过参数修改此路径。

语言和区域设置

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

笔记

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

执照

麻省理工学院

免责声明

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