使用说明

项目简介

MCP Chrome Google Search Tool 是一个基于 Model Context Protocol (MCP) 的服务器实现，它利用 Google Chrome 浏览器，为支持 MCP 协议的 LLM 客户端（如 Claude）提供网页搜索和网页内容提取能力。通过此工具，LLM 可以执行 Google 搜索并获取网页的文本内容，从而扩展其知识范围和信息获取能力。

主要功能点

网页搜索: 允许 LLM 通过 Google 搜索引擎进行关键词搜索，并返回搜索结果（URL 和描述）。支持指定搜索页码、限定搜索站点、以及按时间范围过滤搜索结果。
网页内容提取: 允许 LLM 获取指定 URL 网页的主要文本内容，并可选择包含页面中的链接信息。
Chrome 浏览器驱动: 使用用户本地安装的 Chrome 浏览器执行搜索和内容提取，确保可以访问需要身份验证的网页内容。
macOS 平台支持: 目前仅支持 macOS 操作系统。

安装步骤

安装 Claude Desktop: 确保已安装 Claude Desktop 应用程序（macOS）。
配置 Claude Desktop:
- 打开 Claude Desktop。
- 进入 "Claude" 菜单 > "Settings" > "Developer" > "Edit Config"。
- 在打开的配置文件中，添加以下 JSON 配置到 'mcpServers' 字段中：

{
  "mcpServers": {
    "mcp-chrome-google-search": {
      "command": "npx",
      "args": [
        "-y",
        "@cmann50/mcp-chrome-google-search"
      ]
    }
  }
}

- 保存配置文件并重启 Claude Desktop。

3. 首次运行设置: - 授权辅助功能权限: 首次运行时，系统会弹出 macOS 辅助功能权限请求，请点击 "Allow" 允许。如果未弹出，请手动前往 "System Preferences" > "Security & Privacy" > "Privacy" > "Accessibility"，添加并启用您的终端应用程序（例如 Terminal, iTerm2）。 - 启用 Chrome JavaScript from Apple Events: 打开 Google Chrome 浏览器，前往菜单 "View" > "Developer" > 勾选 "Allow JavaScript from Apple Events"。此步骤只需设置一次。

服务器配置

MCP 客户端 (如 Claude) 需要配置 MCP 服务器的启动信息才能连接并使用该工具。以下是配置 Claude 连接 MCP Chrome Google Search Tool 所需的信息，请将以下 JSON 配置添加到 Claude 的配置文件 ('developer_config.json') 中的 'mcpServers' 字段：

{
  "mcpServers": {
    "mcp-chrome-google-search": {  // 服务器名称，客户端根据此名称识别服务器
      "command": "npx",          // 启动服务器的命令，这里使用 npx 运行 npm 包
      "args": [                  // 启动参数
        "-y",                   // npx 参数，自动确认安装包
        "@cmann50/mcp-chrome-google-search" // 要运行的 npm 包名称
      ]
    }
  }
}

基本使用方法

配置完成后，在 Claude 中，您可以使用以下方式来调用工具：

网页搜索: 在 Claude 中，您可以提问类似 "Search Google for latest news about AI" 或 "Web search for Python documentation on requests library"。Claude 会识别并调用 'web-search' 工具进行搜索，并返回搜索结果。您还可以通过更详细的指令来指定搜索的站点或时间范围。
网页内容提取: 在 Claude 中，您可以提问类似 "Fetch content from https://www.apple.com" 或 "Get text from webpage https://nodejs.org/api/"。Claude 会识别并调用 'web_fetch' 工具来提取指定网页的内容，并返回提取的文本。

注意: 由于该工具通过 Chrome 浏览器自动化执行操作，因此在执行搜索和内容提取时，您会看到 Chrome 浏览器窗口被打开和操作。这是正常现象。为了获得最佳性能，建议定期关闭不再使用的 Chrome 浏览器标签页。

关键词