返回市场
MCP-Chrome-谷歌搜索

MCP-Chrome-谷歌搜索

作者:cmann5021 星标更新:2025-02-02

项目介绍

MCP Chrome Google 搜索工具

使用Chrome浏览器进行Google搜索和网页内容提取的MCP工具。与Claude配合使用,以启用Google搜索和内容抓取功能。

快速安装

  1. 配置Claude桌面版

    • 在Mac上打开Claude桌面版
    • 前往:Claude > 设置 > 开发者 > 编辑配置
    • 将以下内容添加到您的配置文件中:
    {
      "mcpServers": {
        "mcp-chrome-google-search": {
          "command": "npx",
          "args": [
            "-y",
            "@cmann50/mcp-chrome-google-search"
          ]
        }
      }
    }
    
    • 重启Claude桌面版
  2. 首次设置

    • 授予辅助功能权限

      • 首次运行时,批准macOS辅助功能权限提示
      • 导航至:系统偏好设置 > 安全性和隐私 > 隐私 > 辅助功能
      • 添加并启用终端应用的权限
    • 启用Chrome JavaScript从Apple事件

      • 打开Chrome
      • 导航至:视图 > 开发者 > 允许JavaScript从Apple事件
      • 仅需一次设置

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

主要优势

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

平台支持

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

要求

  1. macOS
  2. Google Chrome
  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"
        ]
    }
}

本地开发

要测试本地更改,请提升package.json版本并运行 以进入编辑模式:

npm install -g .

然后只需执行 npm run build,文件将放入dist目录供Claude监控

然后在Claude桌面版中按Ctrl-R,无需重新启动

调试

日志监控

# 实时跟踪日志
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log

开发者工具访问

  1. 启用开发者设置:
echo '{"allowDevTools": true}' > ~/Library/Application\ Support/Claude/developer_settings.json
  1. 打开开发者工具:在Claude桌面版中按Command-Option-Shift-i
  2. 在跟踪日志的同时,在Claude桌面版中使用Ctrl-r以获得更好的错误信息

故障排除

Chrome JavaScript错误

如果您看到:

执行错误:Google Chrome 出现错误:通过AppleScript执行JavaScript已关闭。更多信息:https://support.google.com/chrome/?p=applescript (12)

解决方案:

  1. 打开Chrome
  2. 视图 > 开发者 > 允许JavaScript从Apple事件

辅助功能权限问题

如果Chrome控制失败:

  1. 打开系统偏好设置
  2. 安全性和隐私 > 隐私 > 辅助功能
  3. 确保终端应用已列出并启用
  4. 如需更改,请使用锁图标

实现细节

  • 使用AppleScript控制Chrome
  • 显示自动化 - Chrome窗口将打开/导航
  • 每个请求都会打开一个新的Chrome标签页
  • 定期关闭未使用的标签页以优化性能
  • 仅与受信任的Claude实例一起使用(具有Chrome控制访问权限)

支持

  • 创建GitHub问题报告问题
  • 包括macOS和Chrome版本详情

许可证

MIT许可证 - 查看LICENSE文件获取详细信息