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