Serper Search MCP 服务器

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

✨ 特性

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

🚀 安装

1. 克隆仓库：

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

1. 安装依赖项：

pnpm install

1. 构建服务器：

pnpm run build

⚙️ 配置

1. 从 Serper.dev 获取您的 Serper API 密钥

2. 在根目录下创建一个 .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 提供了分析能力