Serper搜索与网页抓取MCP服务器

这是一个基于TypeScript的MCP服务器，通过Serper API提供网页搜索和网页抓取功能。该服务器与Claude Desktop集成，支持强大的网页搜索和内容提取功能。

功能

工具

• 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=你的_api密钥_在这里

调试

由于MCP服务器通过stdio通信，调试可能具有挑战性。我们建议使用MCP检查器，它作为包脚本可用：

npm run 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": "你的_api密钥_在这里"
      }
    }
  }
}

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": "你的_api密钥_在这里"
      },
      "disabled": false,
      "autoApprove": ["google_search", "scrape"]
    }
  }
}

额外的Cline配置选项：

• disabled：设置为false以启用服务器
• autoApprove：不需要每次使用都明确批准的工具列表

Cursor

1. 打开Cursor设置
2. 打开"功能"设置
3. 在"MCP服务器"部分，点击"添加新的MCP服务器"
4. 选择一个名称，并将"类型"选择为"命令"
5. 在"命令"字段中，输入以下内容：

env SERPER_API_KEY=你的_api密钥_在这里 npx -y serper-search-scrape-mcp-server

Docker

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

docker build -t mcp-server-serper .

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

docker run -e SERPER_API_KEY=你的_api密钥_在这里 mcp-server-serper

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

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

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

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

注意：请确保将你的_api密钥_在这里替换为你的实际Serper API密钥。