Apify MCP Server Rag Web Browser

🚀 モデルコンテキストプロトコル（MCP）サーバー for RAG ウェブブラウザーアクター 🌐

RAG ウェブブラウザーアクター 用の MCP サーバーを実装しました。このアクターは、大規模言語モデル (LLMs) と RAG パイプラインのウェブブラウザーとして機能し、ChatGPT のネットワーク検索に似ています。

🔄 モデルコンテキストプロトコルとは？

モデルコンテキストプロトコル（MCP）により、Claude Desktop などの人工知能アプリケーション（および人工知能エージェント）が外部のツールやデータソースに接続できるようになります。 MCP はオープンプロトコルで、人工知能アプリケーションや人工知能エージェントと、ローカルまたはリモートのリソースとの間で安全かつ制御されたやり取りを実現します。

🎯 この MCP サーバーの機能

RAG ウェブブラウザーアクターにより、AI アシスタントは以下のことができます。

• Google 検索でウェブ検索を実行し、結果から上位 N 個の URL をスクレイピングし、そのクリーンアップされた内容を Markdown 形式で返す
• 単一の URL をスクレイピングし、その内容を Markdown 形式で返す

🧱 コンポーネント

ツール

• search：Google でクエリーワードまたは URL を検索し、結果から上位 N 個の URL をスクレイピングし、クリーンアップされたテキスト内容を返します。
  • パラメータ：
    • query（文字列、必須）：検索ワードまたは URL
    • max_results（数値、オプション）：スクレイピングする最大検索結果数（デフォルト：1）

プロンプト

• search：Google でクエリーフレーズまたは URL を検索し、スクレイピングされたウェブページの内容をテキストまたは Markdown 形式で返します。
  • パラメータ：
    • query（文字列、必須）：検索ワードまたは URL
    • max_results（数値、オプション）：スクレイピングする最大検索結果数（デフォルト：1）

リソース

このサーバーはリソースやプロンプトを提供しません。

🛠️ 設定

前提条件

• MacOS または Windows
• 最新バージョンの Claude Desktop（または他の MCP クライアント）がインストールされていること
• Node.js（v18 以上）
• Apify API Token (APIFY_API_TOKEN)

インストール

Claude Desktop

Claude Desktop を MCP サーバーを認識するように設定します。

1. Claude Desktop の設定ファイルを開き、以下のファイルを編集します。

   • MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

   "mcpServers": {
     "mcp-server-rag-web-browser": {
       "command": "npx",
       "args": [
         "/path/to/mcp-server-rag-web-browser/build/index.js",
       ],
       "env": {
          "APIFY-API-TOKEN": "your-apify-api-token"
       }
     }
   }
   

2. Claude Desktop を再起動します。

   • Claude Desktop を完全に終了します（最小化や閉じた状態ではなく）。
   • Claude Desktop を再起動します。
   • 🔌 アイコンを確認して、Exa サーバーが接続されていることを確認します。

3. 例

   Claude にウェブ検索を実行させることができます。例えば：

   What is an MCP server and how can it be used?
   What is an LLM, and what are the recent news updates?
   Find and analyze recent research papers about LLMs.
   

👷🏼 開発

ローカル開発

未公開のサーバーで作業している場合は、以下のコマンドでローカルサーバーにアクセスできます。

"mcpServers": {
    "mcp-server-rag-web-browser": {
      "command": "/path/to/mcp-server-rag-web-browser/build/index.js",
    },
    "env": {
        "APIFY-API-TOKEN": "your-apify-api-token"
    }
}

ローカルクライアント

サーバーをテストするには、example_client を使用できます。

node build/example_client.js

このスクリプトは MCP サーバーを起動し、利用可能なツールを取得してから、search ツールをクエリーワードで呼び出します。

デバッグ

RAG ウェブブラウザーアクターを呼び出してテストします。

APIFY_API_TOKEN=your-apify-api-token node build/example_call_web_browser.js

MCP サーバーは標準入出力（stdio）で動作するため、デバッグは難しい場合があります。 最適なデバッグ体験を得るには、MCP デバッガー を使用してください。