使用说明

项目简介

Google Search MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型（LLM）提供强大的互联网信息检索和网页内容分析能力。通过集成 Google Custom Search API 和网页内容提取技术，该服务器允许 AI 模型programmatically地执行 Google 搜索并分析网页内容，从而增强模型的上下文理解和信息获取能力。

主要功能点

高级 Google 搜索: 支持关键词搜索，并提供日期、语言、国家、安全搜索等多种过滤选项，以精确定位所需信息。
网页内容提取与分析: 能够从指定的网页 URL 中提取核心内容，去除广告、导航等干扰元素，转换为易于理解的文本格式（Markdown）。
批量网页分析: 支持一次性分析多个网页的内容，方便模型对比不同来源的信息或进行综合信息收集。
MCP 协议兼容: 完全遵循 MCP 协议标准，可以无缝集成到任何支持 MCP 协议的 LLM 客户端，如 Cline 和 Claude。

安装步骤

克隆仓库

git clone https://github.com/mixelpixx/Google-Search-MCP-Server.git
cd Google-Search-MCP-Server

安装 Node.js 依赖
```
npm install
```
安装 Python 依赖
```
pip install -r requirements.txt
```
(注意: 'README.md' 中 'pip install' 命令缺少 '-r requirements.txt'，这里已更正)
构建 TypeScript 代码
```
npm run build
```

创建 API 密钥配置文件 在项目根目录下创建 'api-keys.json' 文件，并填入您的 Google API 密钥和自定义搜索引擎 ID。

{
    "api_key": "YOUR_GOOGLE_API_KEY",
    "search_engine_id": "YOUR_CUSTOM_SEARCH_ENGINE_ID"
}

或者，您也可以将 'GOOGLE_API_KEY' 和 'GOOGLE_SEARCH_ENGINE_ID' 设置为环境变量 (推荐)。

服务器配置 (MCP Client Settings)

要将 Google Search MCP Server 集成到 MCP 客户端（例如 Cline 或 Claude），您需要在客户端的 MCP 设置文件中添加服务器配置信息。以下是配置示例，您需要根据您的实际路径进行调整。

Cline (VS Code Extension) 配置示例 ('%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json')

{
  "mcpServers": {
    "google-search": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\path\\to\\Google-Search-MCP-Server\\dist\\google-search.js"],
      "cwd": "C:\\path\\to\\Google-Search-MCP-Server",
      "env": {
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY",
        "GOOGLE_SEARCH_ENGINE_ID": "YOUR_CUSTOM_SEARCH_ENGINE_ID"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Claude Desktop App 配置示例 ('%APPDATA%\Claude\claude_desktop_config.json')

{
  "mcpServers": {
    "google-search": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\path\\to\\Google-Search-MCP-Server\\dist\\google-search.js"],
      "cwd": "C:\\path\\to\\Google-Search-MCP-Server",
      "env": {
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY",
        "GOOGLE_SEARCH_ENGINE_ID": "YOUR_CUSTOM_SEARCH_ENGINE_ID"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置参数说明:

'"server name"': '"google-search"' - 服务器名称，用于在 MCP 客户端中标识和调用。
'"command"': '"C:\Program Files\nodejs\node.exe"' - Node.js 的可执行文件路径，用于启动 TypeScript MCP 服务器。
'"args"': '["C:\path\to\Google-Search-MCP-Server\dist\google-search.js"]' - 启动 TypeScript MCP 服务器的参数，指向编译后的 'google-search.js' 文件。
'"cwd"': '"C:\path\to\Google-Search-MCP-Server"' - 工作目录，设置为项目根目录。
'"env"': '{ "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY", "GOOGLE_SEARCH_ENGINE_ID": "YOUR_CUSTOM_SEARCH_ENGINE_ID" }' - 环境变量，用于传递 Google API 密钥和自定义搜索引擎 ID。您也可以选择在 'api-keys.json' 文件中配置。
'"disabled"': '"false"' - 设置为 'false' 启用该服务器。
'"autoApprove"': '"[]"' - 自动批准的工具列表，默认为空。

请务必将 '"C:\path\to\Google-Search-MCP-Server"' 和 API 密钥替换为您实际的路径和密钥信息。

基本使用方法

启动服务器 您可以选择以下两种方式启动服务器：

方法 1: 分别启动 Python 和 TypeScript 服务器 (推荐)
- 首先，在项目根目录下打开终端，运行以下命令启动 Python 服务器：
```
npm run start:python
```
- 然后，配置 MCP 客户端，使其仅启动 TypeScript 服务器 (配置示例见 服务器配置 部分)。
方法 2: 一键启动所有服务器
- 在项目根目录下打开终端，运行以下命令一次性启动 Python 和 TypeScript 服务器：
```
npm run start:all
```
在 MCP 客户端中使用工具 服务器成功启动并配置到 MCP 客户端后，您就可以在客户端中使用以下工具：
- 'google_search': 执行 Google 搜索，例如：'{"tool_call": {"name": "google_search", "arguments": {"query": "最新的AI技术发展" } }}'
- 'extract_webpage_content': 提取网页内容，例如：'{"tool_call": {"name": "extract_webpage_content", "arguments": {"url": "https://example.com/article" } }}'
- 'extract_multiple_webpages': 批量提取网页内容，例如：'{"tool_call": {"name": "extract_multiple_webpages", "arguments": {"urls": ["https://example1.com", "https://example2.com"] } }}'
具体的工具参数和使用方法请参考 'README.md' 文件中 "Available Tools" 部分的详细说明。

关键词