Serper 搜索和抓取 MCP 服务器

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

<a href="https://glama.ai/mcp/servers/5zk327i0pj"> <img width="380" height="200" src="https://glama.ai/mcp/servers/5zk327i0pj/badge" alt="serper-search-scrape-mcp-server MCP server" /> </a>

功能

工具

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

  • 丰富的搜索结果，包括自然结果、知识图谱、“人们也会问”和相关搜索
  • 支持区域和语言定位
  • 可选参数，用于位置、分页、时间过滤器和自动更正
  • 支持高级搜索运算符：
    • site: 将结果限制为特定域名
    • filetype: 限制为特定文件类型（例如，“pdf”、“doc”）
    • inurl: 搜索 URL 中包含单词的页面
    • intitle: 搜索标题中包含单词的页面
    • related: 查找相似的网站
    • cache: 查看 Google 缓存的特定 URL 版本
    • 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                  # 运行所有测试
npm run test:watch       # 在监视模式下运行测试
npm run test:coverage    # 运行带有覆盖率的测试
npm run test:integration # 运行集成测试

环境变量

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

SERPER_API_KEY=your_api_key_here

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspector

Inspector 将提供一个 URL 以访问浏览器中的调试工具。

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Serper 搜索和抓取：

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 服务器”选项卡
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: 不需要每次使用都显式批准的工具列表

Cursor

1. 打开 Cursor 设置
2. 打开“功能”设置
3. 在“MCP 服务器”部分中，单击“添加新的 MCP 服务器”
4. 选择一个名称，然后选择“command”作为“类型”
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 密钥。