MCP Server Search

🚀 MCP サーバー検索

このプロジェクトは、Google 検索機能を提供する MCP（モデルコンテキストプロトコル）サーバーです。このサーバーを使用することで、AI モデルがネットワークから最新の情報を取得できるようになります。

✨ 主な機能

• Google 検索を統合し、キャッシュ機能付き
• リクエストの遅延とリトライを設定可能で、限流を回避できる
• シンプルな検索と高度な検索（説明付き）をサポート
• トラフィックを制限し、ランダム化することで、良好なネットワークマナーを維持

📦 インストール

Docker を使用する（推奨）

1. Docker イメージをビルドします。

   docker build -t mcp-server-search .
   

2. 永続化に必要なディレクトリを作成します。

   mkdir -p ./logs ./cache
   

3. コンテナを実行します。

   docker run --rm -i \
     -v "$(pwd)/logs:/app/logs" \
     -v "$(pwd)/cache:/app/cache" \
     mcp-server-search
   

これらのボリュームにより、以下が保証されます。

• ログが ./logs ディレクトリに永続化されます。
• 検索キャッシュが ./cache ディレクトリに永続化されます。
• ディレクトリが存在しない場合、Docker が自動的に作成します。

注意：-i フラグは MCP プロトコル通信に必要で、--rm はコンテナが終了した後に自動的に削除します。

Cline との統合

この MCP サーバーを Cline と一緒に使用するには、Cline の MCP 設定ファイル（VS Code の場合は ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json）に以下の設定を追加します。

{
    "mcpServers": {
        "google_search": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "mcp-server-search"
            ],
            "disabled": false,
            "alwaysAllow": []
        }
    }
}

この設定により、以下のことが行われます。

• 検索 MCP サーバーを Docker コンテナ内で実行するように設定します。
• --rm フラグを使用して、コンテナ終了時に自動的に削除します。
• -i を使用してインタラクティブモードで実行し、MCP プロトコルに必要です。
• デフォルトでサーバーを無効にしています（disabled を false に設定すると有効になります）。
• すべてのツールの使用には明示的な承認が必要です（alwaysAllow が空）。

🔧 設定

このサーバーは、以下のコマンドライン引数を受け付けます。

• --log-level：ログレベルを設定します（DEBUG、INFO、WARNING、ERROR、CRITICAL）。デフォルト：INFO
• --log-file：ログファイルのパス（デフォルト：標準出力）
• --cache-path：検索キャッシュファイルのパス（デフォルト：cache/google_cache.db）
• --request-delay：検索リクエスト間の遅延時間（秒、デフォルト：5）
• --max-retries：失敗した検索の最大リトライ回数（デフォルト：3）

💻 使用例

このサーバーは、以下の MCP エンドポイントを公開しています。

ツール

• google_search：Google 検索を実行し、結果を返します。結果は、タイトル、URL、説明付きの Markdown 形式で返されます（有効にした場合）。

  パラメータ：

  • query (文字列、必須)：実行する検索クエリ
  • num_results (整数、オプション)：返す結果の数（最小値：1、最大値：20、デフォルト：5）
  • use_cache (ブール値、オプション)：キャッシュに利用可能な結果がある場合に使用するかどうか（デフォルト：true）
  • include_descriptions (ブール値、オプション)：説明を含めるかどうか（デフォルト：true）

  特徴：

  • 自動的なリクエストの制限とリトライメカニズム
  • ユーザーエージェントをランダム化し、より良いリクエスト分散を実現
  • ファイルシステムを使用したキャッシュアクセス
  • トラフィック制限

設定例

mcp-server-search コンテナで実行する場合、以下のコマンドでパラメータを渡すことができます。

docker run --rm -i \
    -v "$(pwd)/logs:/app/logs" \
    -v "$(pwd)/cache:/app/cache" \
    mcp-server-search \
    --log-level INFO \
    --log-file /app/logs/search.log \
    --cache-path /app/cache/google_cache.db \
    --request-delay 2 \
    --max-retries 3

設定ファイル

デフォルトでは、サーバーは config.json から設定を読み込みます。以下はサンプルです。

{
    "log_level": "INFO",
    "log_file": "./logs/search.log",
}