Chrome谷歌搜索工具

一款通过Chrome浏览器实现谷歌搜索和网页内容提取的工具,适用于需要自动化搜索和内容抓取的场景。

  • by cmann50
  • HTML
  • 本地部署
  • 25 星标
  • 更新于
在 GitHub 查看 cmann50/mcp-chrome-google-search

使用说明

MCP Chrome谷歌搜索工具

使用Chrome浏览器进行谷歌搜索和网页内容提取的MCP工具。与Claude合作,启用谷歌搜索和内容获取功能。

快速安装

  1. 配置Claude桌面

    • 在Mac上打开克劳德桌面
    • 转到Claude>设置>开发人员>编辑配置
    • 将以下内容添加到配置文件中:
    {
      "mcpServers": {
        "mcp-chrome-google-search": {
          "command": "npx",
          "args": [
            "-y",
            "@cmann50/mcp-chrome-google-search"
          ]
        }
      }
    }
    
    • 重新启动克劳德桌面
  2. 首次设置

    • 授予访问权限

      • 首次运行时,批准macOS辅助功能权限提示
      • 导航到:系统首选项>安全与隐私>隐私>辅助功能
      • 添加并启用终端应用程序的权限
    • 从Apple活动中启用Chrome JavaScript

      • 打开Chrome浏览器
      • 导航到:查看>开发者>允许来自Apple活动的JavaScript
      • 仅限一次性设置

配置后,Claude将能够执行谷歌搜索,并在您发出请求时通过Chrome提取网页内容。

关键优势

  • 免费搜索谷歌
  • 打开小窗口并使用chrome浏览器,因此不应被阻止
  • 由于它正在使用您的Chrome窗口,因此可以访问经过身份验证的内容。Claude可以在浏览器中打开URL。

平台支持

  • ✅ macOS
  • ❌ Windows(不支持)
  • ❌ Linux(不支持)

需求

  1. macOS
  2. 谷歌浏览器
  3. Node.js 20或更高版本

替代安装方法

NPX安装

npx mcp-chrome-google-search

自定义安装

  1. 从git结账
  2. 跑 npm run build
  3. 添加到Claude配置中(使用绝对路径):
{
    "google-tools": {
        "command": "node",
        "args": [
            "/your/checkout/path/mcp/mcp-chrome-google-search/dist/index.js"
        ]
    }
}

地方发展

要在本地测试更改,请运行bump package.json版本并运行 将其置于编辑模式:

npm install -g .

那就做吧 npm run build 这些文件将保存在claude正在监控的dist中

然后在claude桌面按ctrl-R,无需重新启动

调试

日志监控

# Follow logs in real-time
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log

开发工具访问

  1. 启用开发人员设置:
echo '{"allowDevTools": true}' > ~/Library/Application\ Support/Claude/developer_settings.json
  1. 打开DevTools:Claude桌面中的Command-Option-Shift-i
  2. 在Claude桌面中使用ctrl-r,同时尾随以获得更好的错误

故障排除

Chrome浏览器JavaScript错误

如果你看到:

execution error: Google Chrome got an error: Executing JavaScript through AppleScript 
is turned off. For more information: https://support.google.com/chrome/?p=applescript (12)

解决方案:

  1. 打开Chrome浏览器
  2. 查看>开发者>允许在Apple活动中使用JavaScript

无障碍权限问题

如果Chrome控件失败:

  1. 打开系统首选项
  2. 安全与隐私>隐私>可访问性
  3. 确保终端应用程序已列出并启用
  4. 如果需要,使用锁图标进行更改

实现细节

  • 将AppleScript用于Chrome控件
  • 可视化自动化-Chrome窗口将打开/导航
  • 每个请求都会打开一个新的Chrome选项卡
  • 定期关闭未使用的选项卡以获得最佳性能
  • 仅与受信任的Claude实例一起使用(具有Chrome控制访问权限)

支持

  • 为问题创建GitHub问题
  • 包括macOS和Chrome版本详细信息

许可证

MIT许可证-有关详细信息,请参阅许可证文件