RAG Web浏览器 Actor 的模型上下文协议 (MCP) 服务器 🌐

RAG Web浏览器 Actor 的 MCP 服务器实现。 此 Actor 充当大型语言模型 (LLM) 和 RAG 管道的 Web 浏览器，类似于 ChatGPT 中的 Web 搜索。

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

模型上下文协议 (MCP) 使 AI 应用程序（和 AI 代理），例如 Claude Desktop，能够连接到外部工具和数据源。 MCP 是一种开放协议，可实现 AI 应用程序、AI 代理以及本地或远程资源之间的安全、受控交互。

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

RAG Web浏览器 Actor 允许 AI 助手：

• 执行 Web 搜索，抓取结果中排名靠前的 N 个 URL，并将其清理后的内容作为 Markdown 返回
• 获取单个 URL 并将其内容作为 Markdown 返回

🧱 组件

工具

• search: 查询 Google 搜索，抓取结果中排名靠前的 N 个 URL，并返回其清理后的内容作为 Markdown。
  • 参数：
    • query (string, 必需): 搜索词或 URL
    • max_results (number, 可选): 要抓取的最大搜索结果数（默认值：1）

提示

• search: 在 Google 上搜索短语或 URL，并将抓取的网页作为文本或 Markdown 返回
  • 参数：
    • query (string, 必需): 搜索词或 URL
    • max_results (number, 可选): 要抓取的最大搜索结果数（默认值：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 执行 Web 搜索，例如：

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

👷🏼 开发

本地开发

如果您正在开发未发布的服务器，您可以通过以下命令访问本地服务器：

"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 Web浏览器 Actor 来测试它：

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

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

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

npm run build

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

npx @modelcontextprotocol/inspector node ~/apify/mcp-server-rag-web-browser/build/index.js APIFY_API_TOKEN=your-apify-api-token

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