Serper Search MCP サーバー

Serper API を介して Google 検索機能と 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 APIキーを[Serper.dev]( 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

詳細については、 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ファイルを参照してください。

🙏 謝辞

Google検索機能を提供するSerper API
MCPフレームワークのモデルコンテキストプロトコル
分析機能を備えたPostHog

Serper Search MCP Server

Integrations