关键词

Google搜索搜索引擎信息检索知识图谱Serper API

Serper Google Search MCP Server 使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器，它利用 Serper API 提供了强大的 Google 搜索功能。通过集成此服务器，您的 LLM 应用可以轻松获得联网搜索能力，获取最新的信息和知识，从而提升问答、信息检索等任务的性能。

主要功能点

  • Google 搜索集成: 通过 Serper API 实现对 Google 搜索引擎的访问。
  • 结构化搜索结果: 返回包括知识图谱、自然搜索结果、“大家都在问”问题、相关搜索等多种类型的结构化数据。
  • 可配置的搜索参数: 支持设置搜索关键词、结果数量、国家/地区、语言、自动纠错等参数，满足不同的搜索需求。
  • 易于集成和使用: 遵循 MCP 协议，可以方便地集成到支持 MCP 协议的 LLM 客户端中，扩展 LLM 的能力。

安装步骤

  1. 克隆仓库 
    git clone https://github.com/NightTrek/Serper-search-mcp.git
cd Serper-search-mcp
  2. 安装依赖 
    pnpm install
  3. 构建项目 
    pnpm run build

服务器配置

要将 Serper Google Search MCP Server 添加到 MCP 客户端，您需要配置服务器的启动命令。以下是一个配置示例 (JSON 格式)，请根据您的实际安装路径和 Serper API 密钥进行修改。

{
  "mcpServers": {
    "serper-search-server": {  // 服务器名称，可以自定义，用于在客户端中标识该服务器
      "command": "/path/to/serper-search-mcp/build/index.js", // Serper Search MCP 服务器的启动命令，请替换为实际的 index.js 文件路径
      "env": {
        "SERPER_API_KEY": "YOUR_SERPER_API_KEY" // 您的 Serper API 密钥，请替换为您从 Serper.dev 获取的 API 密钥
      }
    }
  }
}

配置参数说明:

  • '"serper-search-server"': 服务器的名称，在 MCP 客户端中用于引用和调用此服务器。您可以自定义此名称。
  • '"command"': 指向服务器可执行文件 'index.js' 的路径。请确保路径正确，指向您在安装步骤中构建的项目目录下的 'build/index.js' 文件。
  • '"env"': 环境变量配置。
    • '"SERPER_API_KEY"': Serper API 密钥。这是访问 Serper API 的凭证，您需要在 Serper.dev 注册账号并获取 API 密钥，然后将其替换 '"YOUR_SERPER_API_KEY"'。

如何获取 Serper API Key:

  1. 访问 Serper.dev 并注册账号。
  2. 登录后，在您的控制面板或 API Keys 页面中创建或复制您的 API Key。

将配置添加到 MCP 客户端 (以 Claude Desktop 为例): 对于支持 MCP 的客户端，例如 Claude Desktop，您需要编辑其配置文件 'claude_desktop_config.json'，并将上述 JSON 配置添加到 '"mcpServers"' 字段中。

  • MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%/Claude/claude_desktop_config.json'

基本使用方法

在 MCP 客户端配置并启动 Serper Google Search MCP Server 后，您可以使用 'serper-google-search' 工具进行 Google 搜索。该工具接受以下参数 (JSON 格式)：

{
  "query": "搜索关键词",  // 必填，您要搜索的内容
  "numResults": 10,    // 可选，返回结果的数量，默认为 10，最大为 100
  "gl": "us",         // 可选，国家/地区代码，例如 "us" (美国), "uk" (英国) 等
  "hl": "en",         // 可选，语言代码，例如 "en" (英语), "zh-CN" (简体中文) 等
  "autocorrect": true  // 可选，是否启用自动纠错，默认为 true
}

例如，在支持自然语言调用的 MCP 客户端中，您可以指示 LLM 使用该工具进行搜索，例如：

请使用 serper-google-search 工具搜索 "最新的人工智能进展"，返回 8 条结果，并将搜索地区设置为美国。

服务器将返回 JSON 格式的搜索结果，客户端可以解析并展示这些结果，或将其用于后续的 LLM 推理任务。

请参考仓库的 'README.md' 文件和 'src/index.ts' 代码了解更详细的参数说明和使用方法。

信息

分类

网页与API

访问项目