使用说明

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 用于分析功能