Apify MCP Server Rag Web Browser

🚀 模型上下文協議（MCP）服務器為 RAG 網頁瀏覽器 Actor 🌐

本項目實現了一個針對 RAG 網頁瀏覽器 Actor 的 MCP 服務器。該 Actor 可作為大型語言模型 (LLMs) 和 RAG 管道的網頁瀏覽器，其功能類似於 ChatGPT 中的網絡搜索。

🚀 快速開始

本 MCP 服務器能讓相關應用像在 ChatGPT 中進行網絡搜索一樣，為大型語言模型和 RAG 管道提供網頁瀏覽功能。只需按照後續的配置步驟操作，即可讓 AI 助手使用該服務器進行網絡搜索和內容抓取。

✨ 主要特性

🔄 模型上下文協議的價值

模型上下文協議（MCP）可使人工智能應用程序（和人工智能代理），如 Claude Desktop，連接到外部工具和數據源。它是一個開放協議，能讓人工智能應用程序、人工智能代理與本地或遠程資源之間實現安全且受控的交互。

🎯 此 MCP 服務器的強大功能

RAG 網頁瀏覽器 Actor 賦予了 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 網頁瀏覽器 Actor 進行測試：

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

由於 MCP 服務器通過標準輸入/輸出（stdio）運行，調試可能具有一定挑戰性。為獲得最佳的調試體驗，建議使用 MCP 調試器。