Serper Search and Scrape MCP Server

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：替代词语（OR 运算符）

• scrape - 提取网页内容

  • 获取纯文本和可选的 Markdown 内容
  • 包含 JSON-LD 和 head 元数据
  • 保留文档结构

要求

• 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

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

安装

通过 Smithery 安装

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

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

Claude Desktop

在以下位置添加服务配置：

• 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"
      }
    }
  }
}

Cline

1. 打开 Cline 扩展设置
2. 打开“MCP Servers”选项卡
3. 点击“Configure MCP Servers”
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：列出每次使用时无需明确批准的工具

Cursor

1. 打开 Cursor 设置
2. 打开“Features”设置
3. 在“MCP Servers”部分，点击“Add new MCP Server”
4. 选择名称，并将“Type”设为“command”
5. 在“Command”字段中输入以下内容：

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 密钥。