关键词

Google 搜索SerperLLM 工具信息检索网络搜索

使用说明

项目简介

Serper Google 搜索 MCP 服务器是一个实现了 Model Context Protocol (MCP) 的后端服务，它将 Serper API 提供的 Google 搜索功能封装成 MCP 工具，使支持 MCP 协议的 LLM 客户端（如 Claude）能够通过调用 'google_search' 工具来获取实时的 Google 搜索结果。这使得 LLM 在对话或执行任务时可以利用最新的网络信息，提高其回答的准确性和时效性。

主要功能点

  • 提供 Google 搜索工具: 通过 'google_search' 工具，LLM 可以向 Google 发起搜索查询并获取结构化的搜索结果 JSON 数据。
  • 支持多种搜索参数: 'google_search' 工具支持丰富的参数，包括查询关键词 ('q')、搜索国家 ('gl')、地理位置 ('location')、语言 ('hl')、时间范围 ('tbs')、结果数量 ('num') 和页码 ('page')，满足不同的搜索需求。
  • 易于集成到 MCP 客户端: 提供了使用 'uv'、'pip' 等多种方式安装和部署服务器的详细说明，并给出了 MCP 客户端配置示例，方便用户快速集成。
  • 基于标准 MCP 协议: 遵循 MCP 协议规范，易于与其他 MCP 组件和客户端协同工作。

安装步骤

本服务器可以通过 'uv' 或 'pip' 进行安装，推荐使用 'uv'，速度更快且更方便。

方法一：使用 'uv' (推荐)

  1. 确保安装 'uv': 如果你的系统上还没有安装 'uv'，请先根据 uv 文档 进行安装。

  2. 配置 MCP 客户端: 在你的 MCP 客户端配置（例如 Claude 的 'claude_desktop_config.json' 文件）中，添加 'serper' MCP 服务器配置。

    {
    "mcpServers": {
        "serper": {
            "command": "uvx",
            "args": ["serper-mcp-server"],
            "env": {
                "SERPER_API_KEY": "<你的 Serper API 密钥>"  // 替换为你的 Serper API 密钥
            }
        }
    }
}

    'uvx' 命令会自动从 pypi.org 下载并运行 'serper-mcp-server'。

方法二：使用 'pip' (项目依赖)

  1. 添加到项目依赖: 如果你的 MCP 客户端项目使用 'requirements.txt' 管理依赖，将 'serper-mcp-server' 添加到 'requirements.txt' 文件中。 
    serper-mcp-server
  2. 安装依赖: 在项目目录下运行命令安装依赖。 
    pip install -r requirements.txt
  3. 配置 MCP 客户端: 在你的 MCP 客户端配置中，添加 'serper' MCP 服务器配置。 
    {
    "mcpServers": {
        "serper": {
            "command": "python3",
            "args": ["-m", "serper_mcp_server"],
            "env": {
                "SERPER_API_KEY": "<你的 Serper API 密钥>"  // 替换为你的 Serper API 密钥
            }
        }
    }
}

方法三：使用 'pip' (全局安装)

  1. 全局安装: 使用 'pip' 或 'pip3' 命令全局安装 'serper-mcp-server'。 
    pip install serper-mcp-server
# 或
pip3 install serper-mcp-server
  2. 配置 MCP 客户端: 在你的 MCP 客户端配置中，添加 'serper' MCP 服务器配置。 
    {
    "mcpServers": {
        "serper": {
            "command": "python3",
            "args": ["serper-mcp-server"],
            "env": {
                "SERPER_API_KEY": "<你的 Serper API 密钥>"  // 替换为你的 Serper API 密钥
            }
        }
    }
}

服务器配置

要使服务器正常工作，你需要 Serper API 密钥。请访问 Serper 官网 注册并获取 API 密钥。

在 MCP 客户端的服务器配置中，你需要设置以下信息：

  • server name: 'serper' (或其他你自定义的名称)
  • command: 服务器启动命令，根据你的安装方式选择 'uvx' 或 'python3'。
  • args: 启动参数，通常为 '["serper-mcp-server"]' 或 '["-m", "serper_mcp_server"]'。
  • env: 环境变量，必须设置 'SERPER_API_KEY' 为你的 Serper API 密钥。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，你可以通过调用 'google_search' 工具来使用 Google 搜索功能。

例如，在 Claude 中，你可以指示 Claude 使用 'google_search' 工具来回答问题：

请使用 google_search 工具搜索一下今天的天气怎么样？

LLM 客户端会将你的指令转换为对 'google_search' 工具的调用，并将搜索结果返回给 LLM，从而 LLM 可以根据最新的搜索结果进行回答。

工具 'google_search' 参数说明:

| 参数名 | 类型 | 必选 | 描述 | 示例 | | ---------- | -------- | ---- | ---------------------------------------- | -------------------------------------- | | 'q' | string | 是 | 搜索关键词 | "今天天气" | | 'gl' | string | 否 | 搜索国家/地区代码 (ISO 3166-1 alpha-2) | "us", "cn", "uk" | | 'location' | string | 否 | 地理位置 | "北京", "London" | | 'hl' | string | 否 | 搜索语言代码 (ISO 639-1 alpha-2) | "zh-CN", "en", "fr" | | 'tbs' | string | 否 | 时间范围 (d:天, w:周, m:月, y:年) | "d", "w", "m" | | 'num' | integer | 否 | 返回结果数量 (最大 100, 默认 10) | 20 | | 'page' | integer | 否 | 返回结果页码 (第一页为 1, 默认 1) | 2 |

信息

分类

网页与API

访问项目