模型上下文协议（MCP）服务器用于 RAG 网页浏览器 Actor 🌐

RAG 网页浏览器 Actor 的 MCP 服务器实现。该 Actor 作为大型语言模型（LLM）和 RAG 管道的网页浏览器，类似于 ChatGPT 中的网页搜索。

🎯 该 MCP 服务器的作用是什么？

该服务器专为快速响应 AI 代理和 LLM 设计，允许它们与网页交互并从网页中提取信息。它运行在本地，并与 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）是一个框架，使 AI 应用（如 Claude Desktop）能够无缝连接到外部工具和数据源。了解更多详情，请访问模型上下文协议网站或阅读博客文章什么是 MCP 以及它为什么重要？。

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

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

有兴趣在 Apify 上构建和盈利自己的 AI 代理？请查看我们的分步指南，了解如何在 Apify 平台上创建、发布和盈利 AI 代理。

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

该服务器通过标准输入/输出（stdio）运行，为 AI 代理提供简单的连接。Apify 提供了其他与 MCP 相关的工具：

服务器选项

🖥️ 此 MCP 服务器 – 本地 stdio 基于的服务器，用于直接与 Claude Desktop 集成
🌐 通过 SSE 的 RAG 网页浏览器 Actor – 通过服务器发送事件直接访问 RAG 网页浏览器，无需运行本地服务器
🇦 MCP 服务器 Actor – 提供 AI 代理访问超过 4,000 个专业 Apify Actor 的 MCP 服务器

客户端选项

💬 测试器 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 服务器。

打开您的 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"
    }
  }
}
```
重新启动 Claude Desktop
- 完全退出 Claude Desktop（确保它不是仅最小化或关闭）。
- 重新启动 Claude Desktop。
- 查找 🔌 图标以确认服务器已连接。

示例

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

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

使用 MCP 检查器调试服务器

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 网页浏览器 Actor：

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

调试

由于 MCP 服务器通过标准输入/输出（stdio）运行，因此调试可能具有挑战性。为获得最佳调试体验，请使用 MCP 检查器。

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

npm run build

您可以通过 npm 使用以下命令启动 MCP 检查器：

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

启动后，检查器将显示一个 URL，您可以在浏览器中访问它以开始调试。

apify/mcp-server-rag-web-browser

星标增长

证据时间轴