Google Search MCP Server 仓库使用说明

Name: Google-Search-MCP-Server
Rating: 8.5 (1591 reviews)
Author: mixelpixx

欢迎来到 Google Search MCP Server 项目的详细介绍页面。此项目由 GitHub 用户 mixelpixx 开发，旨在为开发者提供一个通过 Google 搜索进行网页内容分析的强大工具。该仓库的代码包可访问 GitHub 仓库。

项目背景

目的和应用场景

现今，获取和分析网络信息是众多行业的基础需求。从数据分析师到研究人员，再到个人开发者，快速、准确地进行信息检索和分析对于决策制定至关重要。Google Search MCP Server 提供了一种自动化和系统化的方法来执行 Google 搜索并分析网页内容。此项目是为高效整合 AI 模型和网页数据分析而设计的，主要应用于：

帮助用户通过配置 Google 搜索选项来过滤各种标准（如时间、语言、国家等）进行信息检索；
允许开发者或 AI 模型自动化批量比对和分析多个网页，节省时间和精力；
为需要处理大量数据的网站开发者提供协助，以支持其网页信息处理需求。

项目功能

Google Search MCP Server 提供以下功能，使得用户能够从海量网络信息中提取和处理有价值的数据：

高级 Google 搜索功能：支持通过时间、语言、国家和安全搜索等选项进行高效过滤。
页面内容提取与分析：能够从网站提取详细信息，并进行结构化的分析。
批量页面分析能力：支持多源信息比对，以统一视角观看多网页信息。
环境变量支持：允许通过环境变量配置 API 凭证，增强了安全性和灵活性。
详尽的错误处理与反馈机制：帮助用户快速识别和解决潜在问题。
MCP（Model Context Protocol）兼容接口：保证与 AI 助手的无缝整合。

使用条件

在安装和运行此服务器之前，确保满足以下软件及服务条件：

Node.js：版本要求为 v16 或更高。
Python：版本要求为 v3.8 或更高。
Google Cloud Platform：需要一个有效的谷歌云平台账户。
自定义搜索引擎 ID：为实施Google搜索功能所必须。
Google API Key：用于验证 API请求权限的 API 密钥。

安装指南

以下步骤将指导您如何设置与安装仓库：

克隆仓库

首先，将仓库克隆到本地目录：

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

安装依赖

接着，安装 Node.js 和 Python 的相关依赖：

npm install
pip install flask google-api-python-client flask-cors beautifulsoup4 trafilatura markdownify

构建代码

构建 TypeScript 代码以确保所有功能正常：

npm run build

建立启动脚本

创建一个帮助脚本以启动 Python 服务器（例如，Windows环境下）：

# 创建 start-python-servers.cmd
@echo off
echo Starting Python servers for Google Search MCP...

REM 启动 Python 搜索服务器
start "Google Search API" cmd /k "python google_search.py"

REM 启动 Python 连接查看器
start "Link Viewer" cmd /k "python link_view.py"

echo Python servers started. You can close this window.

配置指南

API 凭证

有两种方式提供谷歌 API 凭证：

环境变量（推荐）：
- 设置 GOOGLE_API_KEY 和 GOOGLE_SEARCH_ENGINE_ID 环境变量。
- 服务器将自动使用这些配置值。

配置文件：

在根目录创建 api-keys.json 文件：

{
    "api_key": "your-google-api-key",
    "search_engine_id": "your-custom-search-engine-id"
}

MCP 设置配置

添加服务器配置到您的 MCP 设置文件：

对于 Cline (VS Code 扩展)

文件位置：

%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\\dist\\google-search.js"],
      "cwd": "C:\\path\\to\\google-search-mcp",
      "env": {
        "GOOGLE_API_KEY": "your-google-api-key",
        "GOOGLE_SEARCH_ENGINE_ID": "your-custom-search-engine-id"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

对于 Claude 桌面应用

文件位置：

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-search": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\path\\to\\google-search-mcp\\dist\\google-search.js"],
      "cwd": "C:\\path\\to\\google-search-mcp",
      "env": {
        "GOOGLE_API_KEY": "your-google-api-key",
        "GOOGLE_SEARCH_ENGINE_ID": "your-custom-search-engine-id"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

运行服务器指南

方法一：分别启动 Python 服务器（推荐）

使用帮助脚本启动 Python 服务器：
```
start-python-servers.cmd
```

配置 MCP 设置以仅运行 Node.js 服务器：

{
  "command": "C:\\Program Files\\nodejs\\node.exe",
  "args": ["C:\\path\\to\\google-search-mcp\\dist\\google-search.js"]
}

方法二：一键启动脚本

使用单个命令启动 TypeScript 和 Python 服务器：

npm run start:all

可用工具概览

Google 搜索工具

执行 Google 搜索并返回相关的网页结果。本工具可以寻找特定选题的网页、文章和信息。

{
  "name": "google_search",
  "arguments": {
    "query": "your search query",
    "num_results": 5, // 可选，默认: 5, 最大: 10
    "date_restrict": "w1", // 可选，限制搜索结果为过去一天(d1)，一周(w1)，一个月(m1)，或一年(y1)
    "language": "en", // 可选，ISO 639-1 语言代码 (en, es, fr, de, ja, 等)
    "country": "us", // 可选，ISO 3166-1 alpha-2 国家代码 (us, uk, ca, au, 等)
    "safe_search": "medium" // 可选，安全搜索级别: "off", "medium", "high"
  }
}

网页内容提取工具

从网页中提取内容，并转换为可读文本。此工具提取主要内容并去除广告、导航元素等杂项。

{
  "name": "extract_webpage_content",
  "arguments": {
    "url": "https://example.com"
  }
}

多网页内容提取工具

在单次请求中提取多个网页的内容，是进行信息跨来源比对或获取主题综合信息的理想选择。

{
  "name": "extract_multiple_webpages",
  "arguments": {
    "urls": [
      "https://example1.com",
      "https://example2.com"
    ]
  }
}

例子应用

以下是 Google Search MCP 工具的一些示例应用：

基本搜索

搜索关于人工智能的信息

带过滤器的高级搜索

搜索关于气候变化的最近新闻，时间限制为过去一周，语言选为西班牙语

内容提取

从 https://example.com/article 提取内容

多内容对比

对以下网站的信息进行比较：
- https://site1.com/topic
- https://site2.com/topic
- https://site3.com/topic

获取 Google API 凭证

请按以下步骤获取并设置 Google API 凭证：

访问 Google Cloud Console
新建项目或选择一个现有项目
启用自定义搜索 API
创建 API 凭证（API Key）
访问 Custom Search Engine 页面
创建新的搜索引擎并获取搜索引擎 ID
将这些凭证加入您的 api-keys.json 文件

错误处理机制

服务器提供详细的错误信息，包括：

API 凭证丢失或无效
搜索请求失败
无效的网页URL
网络连接问题

架构设计

服务器由两个主要组成部分构成：

TypeScript MCP 服务器：负责 MCP 协议通信并提供工具接口。
Python Flask 服务器：管理 Google API 交互和网页内容分析。

许可协议

此项目采用 MIT 许可协议。

Google-Search-MCP-Server