Google 搜索 MCP 服务器

这是一个提供 Google 搜索能力和网页内容分析工具的 MCP（模型上下文协议）服务器。该服务器使 AI 模型能够通过编程方式执行 Google 搜索并分析网页内容。

功能

• 集成 Google 自定义搜索
• 网页内容分析
• 批量网页分析
• 符合 MCP 协议的接口

先决条件

• Node.js（v16 或更高版本）
• Python（v3.8 或更高版本）
• Google Cloud 平台账户
• 自定义搜索引擎 ID
• Google API 密钥

安装

1. 克隆仓库
2. 安装 Node.js 依赖项：

npm install

3. 安装 Python 依赖项：

pip install flask google-api-python-client flask-cors

配置

1. 在根目录下创建一个包含您的 Google API 凭据的 api-keys.json 文件：

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

2. 将服务器配置添加到您的 MCP 设置文件中（通常位于 %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）：

{
  "mcpServers": {
    "google-search": {
      "command": "npm",
      "args": ["run", "start:all"],
      "cwd": "/path/to/google-search-server"
    }
  }
}

构建

npm run build

运行

启动 TypeScript 和 Python 服务器：

npm run start:all

或者分别运行它们：

• TypeScript 服务器：npm start
• Python 服务器：npm run start:python

可用工具

1. search

执行 Google 搜索并检索结果。

{
  "name": "search",
  "arguments": {
    "query": "your search query",
    "num_results": 5 // 可选，默认值：5
  }
}

2. analyze_webpage

从单个网页提取并分析内容。

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

3. batch_analyze_webpages

在单个请求中分析多个网页。

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

获取 Google API 凭证

1. 转到 Google Cloud 控制台
2. 创建一个新的项目或选择现有的项目
3. 启用自定义搜索 API
4. 创建 API 凭证（API 密钥）
5. 转到 自定义搜索引擎 页面
6. 创建新的搜索引擎并获取您的搜索引擎 ID
7. 将这些凭证添加到您的 api-keys.json 文件中

错误处理

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

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

架构

服务器由两个主要组件组成：

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

许可证

MIT