Serper 搜索和抓取 MCP 服务器

一个基于 TypeScript 的 MCP 服务器，使用 Serper API 提供网页搜索和网页抓取功能。该服务器与 Claude Desktop 集成，以实现强大的网页搜索和内容提取功能。

特征

工具

• google_search - 通过 Serper API 执行网络搜索

  • 丰富的搜索结果，包括自然搜索结果、知识图谱、“人们还问”和相关搜索

  • 支持地区和语言定位

  • 位置、分页、时间过滤器和自动更正的可选参数

  • 支持高级搜索运算符：

    • site ：将结果限制在特定域

    • filetype ：限制为特定文件类型（例如“pdf”、“doc”）

    • inurl ：搜索 URL 中包含单词的页面

    • intitle ：搜索标题中包含单词的页面

    • related ：查找类似网站

    • cache ：查看特定 URL 的 Google 缓存版本

    • before ：之前的日期，格式为 YYYY-MM-DD

    • after ：之后的日期，格式为 YYYY-MM-DD

    • exact ：精确短语匹配

    • exclude ：从搜索结果中排除的术语

    • or ：替代术语（或运算符）

• scrape从网页中提取内容

  • 获取纯文本和可选的 markdown 内容

  • 包括 JSON-LD 和头部元数据

  • 保留文档结构

Related MCP server: go_serper_mcp_server

要求

• Node.js >= 18

• Serper API 密钥（设置为SERPER_API_KEY环境变量）

发展

安装依赖项：

npm install

构建服务器：

npm run build

对于使用自动重建的开发：

npm run watch

运行测试：

npm test                  # Run all tests
npm run test:watch       # Run tests in watch mode
npm run test:coverage    # Run tests with coverage
npm run test:integration # Run integration tests

环境变量

在根目录中创建一个.env文件：

SERPER_API_KEY=your_api_key_here

调试

由于 MCP 服务器通过 stdio 进行通信，调试起来可能比较困难。我们推荐使用MCP Inspector ，它以包脚本的形式提供：

npm run inspector

检查器将提供一个 URL 来访问浏览器中的调试工具。

安装

通过 Smithery 安装

要通过Smithery自动安装 Serper Search and Scrape for Claude Desktop：

npx -y @smithery/cli install @marcopesani/mcp-server-serper --client claude

克劳德桌面

添加服务器配置：

• MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "serper-search": {
      "command": "npx",
      "args": ["-y", "serper-search-scrape-mcp-server"],
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

克莱恩

1. 打开 Cline 扩展设置

2. 打开“MCP 服务器”选项卡

3. 点击“配置 MCP 服务器”

4. 添加服务器配置：

{
  "mcpServers": {
    "github.com/marcopesani/mcp-server-serper": {
      "command": "npx",
      "args": ["-y", "serper-search-scrape-mcp-server"],
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": ["google_search", "scrape"]
    }
  }
}

其他 Cline 配置选项：

• disabled ：设置为false以启用服务器

• autoApprove ：每次使用时不需要明确批准的工具列表

光标

1. 打开光标设置

2. 打开“功能”设置

3. 在“MCP 服务器”部分，点击“添加新的 MCP 服务器”

4. 选择一个名称，并选择“命令”作为“类型”

5. 在“命令”字段中输入以下内容：

env SERPER_API_KEY=your_api_key_here npx -y serper-search-scrape-mcp-server

Docker

您也可以使用 Docker 运行服务器。首先，构建镜像：

docker build -t mcp-server-serper .

然后使用您的 Serper API 密钥运行容器：

docker run -e SERPER_API_KEY=your_api_key_here mcp-server-serper

或者，如果您的环境变量在.env文件中：

docker run --env-file .env mcp-server-serper

对于开发，您可能希望将源代码作为卷挂载：

docker run -v $(pwd):/app --env-file .env mcp-server-serper

注意：请确保将your_api_key_here替换为您的实际 Serper API 密钥。