使用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和头部元数据
  • 支持Cookie和JavaScript渲染

要求

• Node.js版本：14.19.1或更高
• 必须设置环境变量SERPER_API_KEY，获取方式请参考官方网站

安装与运行

安装依赖

npm install

构建项目

npm run build

启动服务器

npm start

调试建议

如果遇到问题，请检查以下日志：

• src/utils/logger.ts - 记录基础信息
• src/utils/selenium_logger.ts - 记录浏览器操作日志
• 如果需要调试JavaScript渲染的问题，可以尝试降低Puppeteer的内存限制：

npm run dev --args=--memory=1024MB

安装方式

通过Smithery CLI

npx serper create@mcp-server-serper mcp-server
cd mcp-server
npm install

Claude Desktop配置

方式一：直接运行命令

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

方式二：创建自定义启动项

• 名称：任意名称
• 命令：env SERPER_API_KEY=your_api_key_here npx -y serper-search-scrape-mcp-server

Cline配置

在Cline的“MCP服务器”部分，添加新的服务器：

• 选择“命令”类型
• 在“命令”字段中输入以下内容：

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

Docker运行

构建镜像

docker build -t mcp-server-serper .

启动容器

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