Serper 搜索与抓取 MCP 服务器

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

<a href="https://glama.ai/mcp/servers/5zk327i0pj"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=3852394709,4200997779&fm=3081&app=3081&f=PNG?w=760&h=400" alt="serper-search-scrape-mcp-server MCP 服务器" /> </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 和头部元数据
  • 保留文档结构

要求

• 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 服务器通过标准 I/O 通信，调试可能会很困难。我们推荐使用 MCP Inspector，它作为一个包脚本提供：

npm run inspector

Inspector 将提供一个 URL，以便您可以在浏览器中访问调试工具。

安装

通过 Smithery 安装

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

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. 选择一个名称，并选择“命令”作为类型
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 密钥。