Serper搜索MCP服务器
一个模型上下文协议服务器，通过Serper API和AI驱动的深度研究工具提供谷歌搜索功能。此服务器可将搜索和研究功能轻松集成到启用MCP的应用程序中。
✨ 特性
- 🌐 通过Serper API实现强大的谷歌搜索集成
- 🔄 丰富的搜索响应数据包括：
- 知识图谱信息 - 有机搜索结果 - “人们也会问”问题 - 相关搜索
- 🧠 AI驱动的深度研究工具：
- 执行多步骤迭代研究 - 生成子查询以彻底探索主题 - 综合来自多个来源的信息 - 提供所有信息的引用 - 可调节的研究深度级别 - 内置质量指标，用于持续改进
- 🛠 可配置的搜索参数：
- 国家目标 - 语言选择 - 结果计数自定义 - 自动更正选项
- 🔒 安全的API密钥处理
- ⚡️ 速率限制和缓存支持
- 📝 TypeScript支持完整的类型定义
- 📊 用于结果优化的集成性能指标
🚀 安装
- 克隆存储库：
git clone https://github.com/yourusername/serper-search-server.git
cd serper-search-server- 安装依赖项：
pnpm install- 构建服务器：
pnpm run build⚙️ 配置
- 从\[Seper.dev\]获取您的Serper API密钥(https://serper.de
- 创建一个
.env根目录中的文件：
# Required
SERPER_API_KEY=your_api_key_here
# Optional - Advanced Quality Metrics Configuration (pre-configured by default)
USAGE_METRICS_KEY=your-custom-metrics-key # Optional
USAGE_PROJECT_ID=your-custom-project-id # Optional
METRICS_ENDPOINT=https://your-custom-host.com # Optional
DISABLE_METRICS=false # Not recommended看 遥测.md 有关以下内容的详细信息：
- 质量指标收集
- 性能监控
- 使用情况分析
- 仪表板设置
- 持续改进
🔌 整合
克劳德桌面
将服务器配置添加到Claude Desktop配置中：
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"serper-search-server": {
"command": "/path/to/serper-search-server/build/index.js",
"env": {
"SERPER_API_KEY": "your_api_key_here"
}
}
}
}🛠 用法
搜索工具
服务器提供了一个功能强大的搜索工具，具有以下参数：
{
"query": string, // Search query
"numResults"?: number, // Number of results (default: 10, max: 100)
"gl"?: string, // Country code (e.g., "us", "uk")
"hl"?: string, // Language code (e.g., "en", "es")
"autocorrect"?: boolean, // Enable autocorrect (default: true)
"type"?: "search" // Search type (more types coming soon)
}深度研究工具
为了满足更全面的研究需求，服务器提供了一个深度研究工具，该工具使用以下参数进行多步骤研究：
{
"query": string, // Research query or question
"depth"?: "basic" | "standard" | "deep", // Research depth (default: "standard")
"maxSources"?: number // Maximum sources to include (default: 10)
}深度研究工具：
- 将复杂查询分解为有重点的子查询
- 执行多次搜索以收集全面信息
- 使用人工智能综合来自多个来源的信息
- 使用适当的引用和参考文献格式化结果
- 根据中间结果调整其研究策略
- 收集匿名质量指标以改善搜索结果
深度级别：
- 基础：快速概述（3-5个来源，约5分钟）
适合：简单的事实、快速的定义、直截了当的问题
- 标准：综合分析（5-10个来源，~10分钟）
适用于：大多数研究需求，深度和速度平衡
- 深度：详尽的研究（10+来源，~15-20分钟）
适用于：复杂主题、学术研究、深入分析
搜索工具示例响应
搜索结果包含丰富的数据：
{
"searchParameters": {
"q": "apple inc",
"gl": "us",
"hl": "en",
"autocorrect": true,
"type": "search"
},
"knowledgeGraph": {
"title": "Apple",
"type": "Technology company",
"website": "http://www.apple.com/",
"description": "Apple Inc. is an American multinational technology company...",
"attributes": {
"Headquarters": "Cupertino, CA",
"CEO": "Tim Cook (Aug 24, 2011–)",
"Founded": "April 1, 1976, Los Altos, CA"
}
},
"organic": [
{
"title": "Apple",
"link": "https://www.apple.com/",
"snippet": "Discover the innovative world of Apple...",
"position": 1
}
],
"peopleAlsoAsk": [
{
"question": "What does Apple Inc mean?",
"snippet": "Apple Inc., formerly Apple Computer, Inc....",
"link": "https://www.britannica.com/topic/Apple-Inc"
}
],
"relatedSearches": [
{
"query": "Who invented the iPhone"
}
]
}🔍 响应类型
知识图谱
包含实体信息（如果可用）：
- 标题和类型
- 网站地址
- 描述
- 关键属性
有机结果
搜索结果列表包括：
- 标题和URL
- 片段（描述）
- 结果中的位置
- 网站链接（如果可用）
人们也问
与搜索相关的常见问题：
- 问题文本
- 答案片段
- 源链接
相关搜索
用户经常进行的相关搜索查询列表。
📊 质量指标
深度研究工具包括综合质量指标：
- 研究过程指标
- 性能监控
- 问题跟踪
- 使用模式
- 成果质量指标
看 遥测.md 以获取有关为提高搜索质量而收集的度量的详细信息。
🤝 贡献
欢迎投稿！请随时提交拉取请求。
📝 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙏 致谢
- Serper API公司 提供谷歌搜索功能
- 模型上下文协议 对于MCP框架
- PostHog 用于分析功能
