关键词

网页搜索网页抓取Serper APILLM工具信息检索

Serper Search and Scrape MCP服务器使用说明

项目简介

Serper Search and Scrape MCP服务器是一个基于Model Context Protocol (MCP) 的后端服务，它利用Serper API提供强大的网页搜索和网页内容抓取功能。通过集成此服务器，LLM客户端（如Claude Desktop, Cline, Cursor等）可以调用工具进行网络信息检索和网页数据提取，从而增强LLM在信息获取和处理方面的能力。

主要功能点

  • 网页搜索 (google_search):
    • 使用Serper API执行高效的网络搜索。
    • 支持多种搜索参数，包括关键词、地理位置、语言、时间范围等。
    • 提供丰富的搜索结果，包括自然搜索结果、知识图谱、“人们也会问”等。
    • 支持高级搜索操作符，如 'site:', 'filetype:', 'inurl:', 'intitle:' 等，以实现更精准的搜索。
  • 网页抓取 (scrape):
    • 从指定URL抓取网页内容。
    • 支持提取纯文本和可选的Markdown格式内容。
    • 包含JSON-LD元数据和head元数据，提供全面的网页信息。
    • 保留文档结构，方便LLM理解网页内容。

安装步骤

  1. 安装Node.js: 确保您的系统已安装Node.js (版本 >= 18)。
  2. 安装依赖: 克隆仓库代码后，在项目根目录下运行 'npm install' 安装项目依赖。
  3. 构建服务器: 运行 'npm run build' 命令构建服务器。
  4. 配置Serper API密钥:
    • 获取Serper API密钥并设置为环境变量 'SERPER_API_KEY'。
    • 您可以创建 '.env' 文件在项目根目录，并添加 'SERPER_API_KEY=您的API密钥'。

服务器配置

为了让MCP客户端（如Claude Desktop, Cline, Cursor等）连接到 Serper Search and Scrape MCP服务器，您需要在客户端的MCP服务器配置中添加以下JSON配置。请注意，以下配置为示例，您可以根据实际情况修改服务器名称：

{
  "mcpServers": {
    "serper-search": { // 服务器名称，可以自定义，用于在客户端中标识该服务器
      "command": "npx", // 启动服务器的命令，这里使用 npx 来运行本地安装的 npm 包
      "args": ["-y", "serper-search-scrape-mcp-server"] // 命令参数，-y 表示自动确认执行，serper-search-scrape-mcp-server 是构建后 package.json 中 bin 字段定义的可执行文件名
      // "env": { // 环境变量配置（可选），如果您的 Serper API 密钥没有设置为全局环境变量，可以在这里配置
      //   "SERPER_API_KEY": "您的API密钥"
      // }
    }
  }
}

注意:

  • 'server name' 可以自定义，用于在客户端界面中识别不同的MCP服务器。
  • 'command' 和 'args' 指定了如何启动您的MCP服务器程序。请确保命令和参数与您的项目实际情况相符。
  • 'env' 部分是可选的，如果您的 'SERPER_API_KEY' 已经设置为系统环境变量，则无需在此处再次配置。

基本使用方法

  1. 启动服务器: 在项目根目录下，运行 'npm run watch' (开发模式，自动重启) 或 'npm start' (生产模式) 启动 Serper Search and Scrape MCP服务器。或者直接运行构建后的可执行文件 'serper-search-scrape-mcp-server'。
  2. 配置MCP客户端: 将上述服务器配置JSON添加到您的MCP客户端（如Claude Desktop, Cline, Cursor）的相应配置文件中。
  3. 在LLM中使用工具: 在您的LLM应用中，即可调用 'google_search' 和 'scrape' 工具进行网页搜索和内容抓取。工具的具体使用参数请参考工具的描述信息。您还可以尝试使用预定义的 Prompt 模板，例如 'research-topic' 等，以更结构化的方式进行信息检索。

信息

分类

网页与API

访问项目