mcp-server-serper

🚀 使用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

其他安装方式

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

💡 使用建议

调试建议

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

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

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