Serper Search and Scrape MCP Server

基本能力

产品定位

mcp-server-serper 是一个专注于网页搜索和内容抓取的 MCP 服务器，旨在通过 Serper API 提供高效的搜索和抓取功能。

核心功能

1. 网页搜索 (google_search):
2. 通过 Serper API 进行网页搜索
3. 支持丰富的搜索结果，包括有机结果、知识图谱、"人们也问"和相关搜索
4. 支持区域和语言定位
5. 可选参数包括位置、分页、时间过滤器和自动校正

6. 支持高级搜索操作符，如 site、filetype、inurl、intitle 等

7. 网页抓取 (scrape):

8. 从网页中提取内容
9. 获取纯文本和可选的 Markdown 内容
10. 包括 JSON-LD 和头部元数据
11. 保留文档结构

适用场景

1. 需要集成高级网页搜索功能的应用程序
2. 需要从网页中提取结构化数据的项目
3. 自动化浏览器操作和内容收集
4. 数据挖掘和信息聚合

工具列表

1. google_search: 提供全面的网页搜索功能，支持多种高级搜索操作符。
2. scrape: 从网页中提取内容，支持多种输出格式和元数据提取。

常见问题解答

1. 如何获取 Serper API 密钥？

2. 需要注册 Serper API 服务并获取 API 密钥，然后设置为 SERPER_API_KEY 环境变量。

3. 如何调试 MCP 服务器？

4. 推荐使用 MCP Inspector 进行调试。

5. 如何在不同平台上安装？

6. 支持通过 Smithery、Claude Desktop、Cline、Cursor 和 Docker 多种方式安装。

使用教程

使用依赖

• Node.js >= 18
• Serper API 密钥（设置为 SERPER_API_KEY 环境变量）

安装教程

1. 通过 Smithery 安装

npx -y @smithery/cli install @marcopesani/mcp-server-serper --client claude

1. 通过 Docker 安装

docker build -t mcp-server-serper .
docker run -e SERPER_API_KEY=your_api_key_here mcp-server-serper

1. 手动安装

npm install
npm run build

调试方式

1. 使用 MCP Inspector 进行调试

npm run inspector

1. 运行测试

npm test                  # 运行所有测试
npm run test:watch       # 在监视模式下运行测试
npm run test:coverage    # 运行测试并生成覆盖率报告
npm run test:integration # 运行集成测试

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。