Serper Search MCP 服务器

一个通过 Serper API 提供 Google 搜索功能的 Model Context Protocol 服务器，同时配备了一个由 AI 驱动的深度研究工具。该服务器能够轻松地将搜索和研究功能集成到您的 MCP 支持的应用程序中。

✨ 特性

🌐 通过 Serper API 强大的 Google 搜索集成
🔄 丰富的搜索响应数据包括：
- 知识图谱信息
- 自然搜索结果
- “人们也问”问题
- 相关搜索
🧠 由 AI 驱动的深度研究工具：
- 执行多步骤、迭代式研究
- 生成子查询以全面探索主题
- 从多个来源综合信息
- 为所有信息提供引用
- 可调节的研究深度级别
- 内置质量指标以持续改进
🛠 可配置的搜索参数：
- 国家定位
- 语言选择
- 结果数量自定义
- 自动更正选项
🔒 安全的 API 密钥处理
⚡️ 速率限制和支持缓存
📝 具有完整类型定义的 TypeScript 支持
📊 用于结果优化的集成性能指标

🚀 安装

克隆仓库：

git clone https://github.com/yourusername/serper-search-server.git
cd serper-search-server

安装依赖项：

pnpm install

构建服务器：

pnpm run build

⚙️ 配置

从 Serper.dev 获取您的 Serper API 密钥
在根目录下创建一个 .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

有关以下内容的详细信息，请参阅 TELEMETRY.md：

质量指标收集
性能监控
使用分析
仪表板设置
持续改进

🔌 集成

Claude 桌面版

将服务器配置添加到您的 Claude Desktop 配置中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %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)
}

深度研究工具：

将复杂查询分解为专注的子查询
执行多次搜索以收集全面信息
使用 AI 从多个来源综合信息
用适当的引文和参考资料格式化结果
根据中间结果调整其研究策略
收集匿名质量指标以改进搜索结果

深度级别：

basic: 快速概览（3-5 个来源，约 5 分钟）
适合：简单事实、快速定义、直接问题
standard: 全面分析（5-10 个来源，约 10 分钟）
适合：大多数研究需求，平衡深度与速度
deep: 彻底研究（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
描述
关键属性

自然搜索结果

包括以下内容的搜索结果列表：

标题和URL
摘要（描述）
在结果中的位置
可用时提供站点链接

人们也问

与搜索相关的常见问题：

问题文本
答案摘要
来源链接

📊 质量指标

深度研究工具包括集成的质量指标：

研究过程指标
性能监控
问题跟踪
使用模式
结果质量指示器

有关收集以改进搜索质量的指标的详细信息，请参阅 TELEMETRY.md。

🤝 贡献

欢迎贡献！请随时提交Pull Request。

📝 许可证

本项目根据MIT许可证授权 - 详情请见 LICENSE 文件。

🙏 致谢

Serper API 提供了Google搜索功能
Model Context Protocol 提供了MCP框架
PostHog 提供了分析能力