基本能力
产品定位
mcp-server-serper 是一个专注于网页搜索和内容抓取的 MCP 服务器,旨在通过 Serper API 提供高效的搜索和抓取功能。
核心功能
- 网页搜索 (
google_search
): - 通过 Serper API 进行网页搜索
- 支持丰富的搜索结果,包括有机结果、知识图谱、"人们也问"和相关搜索
- 支持区域和语言定位
- 可选参数包括位置、分页、时间过滤器和自动校正
-
支持高级搜索操作符,如
site
、filetype
、inurl
、intitle
等 -
网页抓取 (
scrape
): - 从网页中提取内容
- 获取纯文本和可选的 Markdown 内容
- 包括 JSON-LD 和头部元数据
- 保留文档结构
适用场景
- 需要集成高级网页搜索功能的应用程序
- 需要从网页中提取结构化数据的项目
- 自动化浏览器操作和内容收集
- 数据挖掘和信息聚合
工具列表
google_search
: 提供全面的网页搜索功能,支持多种高级搜索操作符。scrape
: 从网页中提取内容,支持多种输出格式和元数据提取。
常见问题解答
- 如何获取 Serper API 密钥?
-
需要注册 Serper API 服务并获取 API 密钥,然后设置为
SERPER_API_KEY
环境变量。 -
如何调试 MCP 服务器?
-
推荐使用 MCP Inspector 进行调试。
-
如何在不同平台上安装?
- 支持通过 Smithery、Claude Desktop、Cline、Cursor 和 Docker 多种方式安装。
使用教程
使用依赖
- Node.js >= 18
- Serper API 密钥(设置为
SERPER_API_KEY
环境变量)
安装教程
-
通过 Smithery 安装
bash
npx -y @smithery/cli install @marcopesani/mcp-server-serper --client claude -
通过 Docker 安装
bash
docker build -t mcp-server-serper .
docker run -e SERPER_API_KEY=your_api_key_here mcp-server-serper -
手动安装
bash
npm install
npm run build
调试方式
-
使用 MCP Inspector 进行调试
bash
npm run inspector -
运行测试
bash
npm test # 运行所有测试
npm run test:watch # 在监视模式下运行测试
npm run test:coverage # 运行测试并生成覆盖率报告
npm run test:integration # 运行集成测试