使用说明

项目简介

'google-search' 是一个开源项目，它作为一个 Model Context Protocol (MCP) 服务器，为大型语言模型（LLM）客户端，如 Claude，提供实时的 Google 搜索能力。它无需依赖付费的搜索引擎 API，直接在本地执行搜索，并能有效绕过反爬虫机制，保证搜索的成功率和数据的准确性。通过简单的配置，即可将实时的网络搜索功能集成到您的 AI 应用中。

主要功能点

本地 Google 搜索服务: 无需付费API，所有搜索都在本地进行。
绕过反爬虫机制: 采用多种技术，如模拟用户行为、浏览器状态管理等，提高搜索成功率。
MCP 服务器集成: 实现了 MCP 协议，可以轻松集成到支持 MCP 协议的 AI 助手，如 Claude。
完全开源免费: 代码开源，无使用限制，可自由定制和扩展。
返回结构化结果: 搜索结果包含标题、链接和摘要，以 JSON 格式返回，方便程序解析和使用。

安装步骤

克隆仓库:

git clone https://github.com/web-agent-master/google-search.git
cd google-search

安装依赖: 根据您使用的包管理器选择以下命令之一：

npm install

或

yarn

或

pnpm install

编译代码:

npm run build

或

yarn build

或

pnpm build

全局链接 (MCP 功能必需):

npm link

或

yarn link

或

pnpm link

服务器配置

要将 'google-search' MCP 服务器集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的配置文件。以下是针对 Claude Desktop 的配置示例，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'，该文件通常位于：

Mac: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%\Claude\claude_desktop_config.json' (通常是 'C:\Users\username\AppData\Roaming\Claude\claude_desktop_config.json')

在 'claude_desktop_config.json' 文件中的 'mcpServers' 字段下添加 'google-search' 服务器的配置。

配置示例 (JSON):

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": ["google-search-mcp"]
    }
  }
}

配置参数说明:

'"google-search"': 服务器名称，您可以自定义，用于在客户端中标识该服务器。
'"command": "npx"': 启动服务器的命令。 'npx' 用于执行本地安装的 npm 包的可执行文件。
'"args": ["google-search-mcp"]': 命令的参数。 'google-search-mcp' 是 'google-search' 项目提供的 MCP 服务器启动脚本。

Windows 环境配置示例:

如果 'npx' 命令在 Windows 环境下可能存在兼容性问题，您可以尝试以下配置：

使用 'cmd.exe' 和 'npx':

{
  "mcpServers": {
    "google-search": {
      "command": "cmd.exe",
      "args": ["/c", "npx", "google-search-mcp"]
    }
  }
}

使用 'node' 和完整路径 (推荐):

{
  "mcpServers": {
    "google-search": {
      "command": "node",
      "args": ["C:/path/to/your/google-search/dist/mcp-server.js"]
    }
  }
}

注意: 使用 'node' 完整路径配置时，请将 '"C:/path/to/your/google-search"' 替换为您实际安装 'google-search' 包的路径。

配置完成后，重启 Claude Desktop 或您的 MCP 客户端，配置即可生效。

基本使用方法

成功配置并启动 'google-search' MCP 服务器后，在您的 MCP 客户端（例如 Claude Desktop）中，您可以使用类似 'search for [关键词]' 或 '使用 google-search 工具搜索 [关键词]' 的指令来触发 Google 搜索。具体的指令格式取决于您的 MCP 客户端的实现。

例如，在 Claude 中，您可能可以直接输入：

search for 最新人工智能研究

或

使用 google-search 工具搜索 气候变化的影响

服务器会将搜索结果以 JSON 格式返回给客户端，客户端可以根据结果进行后续处理或展示。

关键词