Model Context Protocol (MCP) 服务器用于 RAG 网页浏览器 Actor 🌐

这是为 RAG 网页浏览器 Actor 实现的一个 MCP 服务器。这个 Actor 作为大型语言模型（LLMs）和 RAG 流水线的网页浏览器，类似于 ChatGPT 中的网络搜索功能。

🎮 这个 MCP 服务器的作用是什么？

该服务器专门设计用于向 AI 代理和 LLMs 提供快速响应，使它们能够与网页交互并从网页中提取信息。
它在本地运行，并以待机模式与RAG 网页浏览器 Actor通信，
发送搜索查询并接收作为响应的提取网页内容。

RAG 网页浏览器 Actor 允许 AI 助手：

• 执行网络搜索，抓取结果中的前 N 个 URL，并将它们的清理后的内容作为 Markdown 返回
• 获取单个 URL 并将其内容作为 Markdown 返回

🥱 组件

工具

• search: 查询 Google 搜索，抓取结果中的前 N 个 URL，并返回它们清理后的 Markdown 格式内容。参数：
  • query (字符串, 必填): 搜索词或 URL
  • maxResults (数字, 可选): 要抓取的最大搜索结果数量 (默认: 1)
  • scrapingTool (字符串, 可选): 选择用于提取网页的抓取工具。选项：'browser-playwright' 或 'raw-http' (默认: 'raw-http')
  • outputFormats (数组, 可选): 选择一个或多个输出格式。选项：'text', 'markdown', 'html' (默认: ['markdown'])
  • requestTimeoutSecs (数字, 可选): 请求的最大时间（秒）(默认: 40)

📄 什么是模型上下文协议？

模型上下文协议 (MCP) 是一个框架，它使得像 Claude Desktop 这样的 AI 应用程序能够无缝地连接到外部工具和数据源。
欲了解更多信息，请访问 模型上下文协议网站 或阅读博客文章 什么是 MCP 以及为什么它很重要？。

🤖 MCP 服务器如何与 AI 代理集成？

MCP 服务器通过 RAG 网页浏览器 Actor 使 AI 代理能够执行网络搜索和浏览。
要全面了解 AI 代理，请查看我们的博客文章：什么是 AI 代理？，并探索 Apify 的 代理。

对在 Apify 上构建并货币化您自己的 AI 代理感兴趣吗？请查看我们关于在 Apify 平台上创建、发布和货币化 AI 代理的分步指南。

📎 Apify 提供的相关 MCP 服务器和客户端

此服务器通过标准输入/输出(stdio)操作，提供与 AI 代理的直接连接。Apify 还提供了其他几个与 MCP 相关的工具：

服务器选项

• 🖥️ 该 MCP 服务器 —— 一个基于本地 stdio 的服务器，用于直接与 Claude Desktop 集成
• 🌐 通过 SSE 的 RAG Web 浏览器 Actor —— 无需运行本地服务器，直接通过 Server-Sent Events 访问 RAG Web 浏览器
• 🇦 MCP 服务器 Actor —— 提供 AI 代理访问超过 4,000 个专业 Apify Actors 的 MCP 服务器

客户端选项

• 💬 Tester MCP 客户端 —— 一个用户友好的界面，用于与任何基于 SSE 的 MCP 服务器交互

🛠️ 配置

前提条件

• MacOS 或 Windows
• 必须安装最新版本的 Claude Desktop（或另一个 MCP 客户端）
• Node.js (v18 或更高版本)
• Apify API 令牌 (APIFY_TOKEN)

安装

按照以下步骤在本地机器上设置并运行服务器：
首先，使用以下命令克隆仓库：

git clone git@github.com:apify/mcp-server-rag-web-browser.git

导航到项目目录并安装所需的依赖项：

cd mcp-server-rag-web-browser
npm install

在运行服务器之前，需要构建项目：

npm run build

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": {
     "rag-web-browser": {
       "command": "npx",
       "args": [
         "@apify/mcp-server-rag-web-browser"
       ],
       "env": {
          "APIFY_TOKEN": "your-apify-api-token"
       }
     }
   }
   

2. 重启 Claude Desktop

   • 完全退出 Claude Desktop（确保它不是最小化或关闭）。
   • 重新启动 Claude Desktop。
   • 查找 🔌 图标以确认服务器已连接。

3. 示例

   您可以让 Claude 执行网页搜索，例如：

   MCP 服务器是什么，如何使用？
   LLM 是什么，最近有什么新闻更新？
   查找并分析关于 LLMs 的近期研究论文。
   

使用 MCP Inspector 调试服务器

export APIFY_TOKEN=your-apify-api-token
npx @modelcontextprotocol/inspector npx -y @apify/mcp-server-rag-web-browser

👷🏼 开发

本地客户端 (stdio)

要本地测试服务器，可以使用 example_client_stdio.ts：

export APIFY_TOKEN=your-apify-api-token
node dist/example_client_stdio.js

脚本将启动 MCP 服务器，获取可用工具，然后用查询调用 search 工具。

直接 API 调用

要测试直接调用 RAG Web 浏览器 Actor：

export APIFY_TOKEN=your-apify-api-token
node dist/example_call_web_browser.js

调试

由于 MCP 服务器通过标准输入/输出 (stdio) 运行，调试可能会有挑战。
为了获得最佳调试体验，请使用 MCP Inspector。

构建 mcp-server-rag-web-browser 包：

npm run build

你可以通过以下命令使用 npm 启动 MCP Inspector：

export APIFY_TOKEN=your-apify-api-token
npx @modelcontextprotocol/inspector node dist/index.js

启动后，Inspector 会显示一个 URL，你可以在浏览器中访问该 URL 以开始调试。