关键词

网页搜索谷歌搜索搜索引擎信息检索互联网访问

项目简介

该项目是一个基于 Model Context Protocol (MCP) 的服务器实现，它将 Google Custom Search Engine (CSE) 的搜索能力封装成一个工具，供 LLM (大型语言模型) 客户端调用。通过此服务器，LLM 可以利用 Google CSE 进行网页搜索，获取信息并用于生成更丰富的回答或执行相关任务。

主要功能点

  • 网页搜索: 提供 'google_search' 工具，允许 LLM 根据用户提供的关键词进行网页搜索。
  • 返回搜索结果: 工具返回搜索结果的标题、链接和摘要（snippet），方便 LLM 理解搜索结果。
  • MCP 标准协议: 遵循 MCP 协议，易于与各种支持 MCP 协议的 LLM 客户端集成。
  • 灵活配置: 支持通过环境变量配置 Google CSE API 密钥、引擎 ID 等参数。

安装步骤

  1. 安装 Python 包: 可以使用 'pip' 安装 'mcp-google-cse' 包。 
    pip install mcp-google-cse

服务器配置

对于 MCP 客户端（例如 Claude），您需要在客户端的配置文件中添加此服务器的配置信息。以下是配置示例，请根据您的实际情况填写 'API_KEY' 和 'ENGINE_ID'。

{
  "serverName": "mcp-google-cse",
  "command": "python",
  "args": ["-m", "mcp-google-cse"],
  "env": {
    "API_KEY": "YOUR_GOOGLE_CSE_API_KEY",
    "ENGINE_ID": "YOUR_GOOGLE_CSE_ENGINE_ID"
  }
}
  • 'serverName': 服务器名称，可以自定义，用于在客户端配置文件中标识该服务器。
  • 'command': 启动服务器的命令，这里使用 'python'。
  • 'args': 启动服务器的参数，'-m mcp-google-cse' 表示运行 'mcp-google-cse' 模块。
  • 'env': 环境变量配置，需要您配置以下两个必要的环境变量：
    • 'API_KEY': 必需。您的 Google Custom Search Engine API 密钥。请参考仓库 README.md 中的 "CSE Setup" 部分获取。
    • 'ENGINE_ID': 必需。您的 Google Custom Search Engine 引擎 ID。请参考仓库 README.md 中的 "CSE Setup" 部分获取。
    • 其他可选环境变量，如 'SERVICE_NAME', 'COUNTRY_REGION', 'GEOLOCATION', 'RESULT_LANGUAGE', 'RESULT_NUM'，可以根据需要配置，具体含义请参考仓库 README.md 的 "Environment variables" 部分。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您可以使用 'google_search' 工具进行网页搜索。例如，在 Claude 中，您可以这样调用：

google_search("最新的 MCP 协议进展")

LLM 客户端会将此工具调用请求发送到 'mcp-google-cse' 服务器，服务器执行搜索并将结果返回给客户端，最终 LLM 会根据搜索结果生成回复。

信息

分类

网页与API

访问项目