🚀 模型上下文协议（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 调试器。