Skip to main content
Glama
Serper Search MCP Server

Serper Search MCP Server

by NightTrek

Serper Search MCP サーバー

Serper API を介して Google 検索機能と AI を活用したディープリサーチツールを提供するモデルコンテキストプロトコルサーバーです。このサーバーにより、MCP 対応アプリケーションに検索機能とリサーチ機能を簡単に統合できます。

✨ 特徴

  • 🌐 Serper API による強力な Google 検索統合

  • 🔄豊富な検索応答データには以下が含まれます:

    • ナレッジグラフ情報

    • オーガニック検索結果

    • 「よく聞かれる質問」

    • 関連検索

  • 🧠 AI を活用したディープリサーチツール:

    • 複数段階の反復的な調査を実行する

    • トピックを徹底的に調査するためのサブクエリを生成する

    • 複数の情報源からの情報を統合する

    • すべての情報の引用を提供します

    • 調整可能な調査深度レベル

    • 継続的な改善のための組み込み品質指標

  • 🛠 設定可能な検索パラメータ:

    • 国別ターゲティング

    • 言語の選択

    • 結果数のカスタマイズ

    • 自動修正オプション

  • 🔒 安全なAPIキーの取り扱い

  • ⚡️ レート制限とキャッシュのサポート

  • 📝 完全な型定義を備えた TypeScript サポート

  • 📊 結果の最適化のための統合パフォーマンスメトリック

Related MCP server: google-search-mcp

🚀 インストール

  1. リポジトリをクローンします。

git clone https://github.com/yourusername/serper-search-server.git
cd serper-search-server
  1. 依存関係をインストールします:

pnpm install
  1. サーバーを構築します。

pnpm run build

⚙️ 構成

  1. Serper APIキーを[Serper.dev]( https://serper.de )から取得します。

  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 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を使用して複数の情報源からの情報を統合する

  • 適切な引用と参照を使用して結果をフォーマットします

  • 中間結果に基づいて研究戦略を調整する

  • 検索結果を改善するために匿名の品質指標を収集します

深度レベル:

  • 基本:簡単な概要(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

  • 説明

  • 主な属性

オーガニック検索結果

検索結果のリストには以下が含まれます:

  • タイトルとURL

  • スニペット(説明)

  • 結果における順位

  • 利用可能な場合のサイトリンク

よくある質問

検索に関するよくある質問:

  • 質問文

  • 回答抜粋

  • ソースリンク

関連検索

ユーザーが頻繁に行う関連検索クエリのリスト。

📊 品質メトリクス

Deep Research ツールには統合された品質メトリックが含まれています。

  • 研究プロセスの指標

  • パフォーマンス監視

  • 問題追跡

  • 使用パターン

  • 結果品質指標

検索品質を向上させるために収集されるメトリックの詳細については、 TELEMETRY.md を参照してください。

🤝 貢献する

貢献を歓迎します!お気軽にプルリクエストを送信してください。

📝 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

Available Tools

1 tool

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    There is only one tool, so there is no possibility of selecting the wrong one. Its purpose (run a Google search via Serper) is clearly stated.

    Naming Consistency4/5

    The single name 'serper-google-search' is descriptive and uses a consistent kebab-case style, but it is a compound noun rather than a verb_noun action pattern. With only one tool there is no broader convention to judge against.

    Tool Count3/5

    One tool is thin for a server whose stated purpose is exposing the Serper search API, which supports multiple result types. It is functional but leaves the surface minimal.

    Completeness3/5

    A general web search covers the core use case and returns rich payloads, but the Serper API's other endpoints (news, images, places/maps, scholar, webpage scraping) are absent. Agents needing those result types have no path forward with this server.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Google Search, News, and Places queries via the Serper API, integrated with the Pipeworx MCP gateway.
      324 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to run live Google searches and retrieve organic results, snippets, sitelinks, People Also Ask, related searches, and Google's AI Overview with citations via a zero-dependency MCP server.
      2
      MIT