Serper Search MCP 服务器

一个模型上下文协议服务器，通过 Serper API 提供 Google 搜索功能，以及一个 AI 驱动的深度研究工具。 此服务器使您可以轻松地将搜索和研究功能集成到您的 MCP 应用程序中。

✨ 功能

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

🚀 安装

1. 克隆存储库：

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

2. 安装依赖项：

pnpm install

3. 构建服务器：

pnpm run build

⚙️ 配置

1. 从 [Serper.dev](https://serper.de 获取您的 Serper API 密钥

2. 在根目录中创建一个 .env 文件：

# 必需
SERPER_API_KEY=your_api_key_here

# 可选 - 高级质量指标配置（默认情况下已预配置）
USAGE_METRICS_KEY=your-custom-metrics-key     # 可选
USAGE_PROJECT_ID=your-custom-project-id       # 可选
METRICS_ENDPOINT=https://your-custom-host.com # 可选
DISABLE_METRICS=false                         # 不推荐

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

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

🔌 集成

Claude Desktop

将服务器配置添加到您的 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,          // 搜索查询
  "numResults"?: number,    // 结果数（默认值：10，最大值：100）
  "gl"?: string,           // 国家/地区代码（例如，“us”，“uk”）
  "hl"?: string,           // 语言代码（例如，“en”，“es”）
  "autocorrect"?: boolean, // 启用自动更正（默认值：true）
  "type"?: "search"        // 搜索类型（更多类型即将推出）
}

深度研究工具

对于更全面的研究需求，该服务器提供了一个深度研究工具，该工具执行多步骤研究，具有以下参数：

{
  "query": string,          // 研究查询或问题
  "depth"?: "basic" | "standard" | "deep",  // 研究深度（默认值：“standard”）
  "maxSources"?: number     // 要包含的最大来源数（默认值：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。

🤝 贡献

欢迎贡献！ 请随时提交拉取请求。

📝 许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。

🙏 致谢

• Serper API 提供 Google 搜索功能
• 模型上下文协议 提供 MCP 框架
• PostHog 提供分析功能