RAG Web Browser MCP 服务器使用说明

项目简介

RAG Web Browser MCP 服务器旨在为大型语言模型(LLM)提供网页浏览和信息检索能力,类似于在 ChatGPT 中进行网页搜索。它允许 LLM 通过工具调用访问和分析网络内容,从而增强 LLM 的知识获取和信息处理能力。

主要功能点

  • 网页搜索工具 (search): 提供 'search' 工具,允许 LLM 发起网页搜索,抓取 Google 搜索结果中排名靠前的网页,并返回清洗后的 Markdown 格式内容。
  • URL 内容抓取: 支持通过 'search' 工具抓取指定 URL 的网页内容,并以 Markdown 格式返回。
  • MCP 协议支持: 遵循 Model Context Protocol (MCP) 协议,可以通过标准 JSON-RPC 接口与 MCP 客户端进行通信。
  • 多种传输协议: 支持通过标准输入/输出 (stdio) 和服务器发送事件 (SSE) 等多种传输协议与 MCP 客户端通信。

安装步骤

  1. 克隆仓库: 打开终端,执行以下命令克隆仓库到本地:
    git clone [email protected]:apify/mcp-server-rag-web-browser.git
  2. 进入项目目录: 使用 'cd' 命令进入克隆下来的项目目录:
    cd mcp-server-rag-web-browser
  3. 安装依赖: 运行 'npm install' 命令安装项目所需的依赖包:
    npm install
  4. 构建项目: 执行 'npm run build' 命令编译 TypeScript 代码,生成可执行的 JavaScript 文件:
    npm run build

服务器配置

对于 MCP 客户端(例如 Claude Desktop),您需要配置服务器连接信息。以下是一个配置示例,用于配置 Claude Desktop 连接 RAG Web Browser MCP 服务器:

{
  "mcpServers": {
    "rag-web-browser": {  // MCP 服务器名称,可以自定义
      "command": "npx",  // 启动服务器的命令,通常为 npx 或 node
      "args": [
        "/path/to/mcp-server-rag-web-browser/build/index.js"  // 服务器启动脚本路径,请替换为实际路径
      ],
      "env": {
        "APIFY_API_TOKEN": "YOUR_APIFY_API_TOKEN"  // Apify API Token,用于访问 RAG Web Browser Actor,请替换为您的 Token
      }
    }
  }
}

配置说明:

  • '"rag-web-browser"': 是您为该 MCP 服务器在客户端中定义的名称,可以根据需要自定义。
  • '"command"': 指定启动服务器的命令,通常为 'npx' 或 'node',确保您的系统已安装 Node.js 和 npm。
  • '"args"': 是一个字符串数组,包含启动服务器脚本的路径。请将 '/path/to/mcp-server-rag-web-browser/build/index.js' 替换为您本地仓库 'build/index.js' 文件的绝对路径
  • '"env"': 用于设置环境变量。'APIFY_API_TOKEN' 是访问 Apify 平台的 API 密钥,RAG Web Browser Actor 依赖此 Token 进行调用。您需要在 Apify 平台 获取 API Token 并替换 '"YOUR_APIFY_API_TOKEN"'。

Claude Desktop 配置文件路径:

  • macOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%/Claude/claude_desktop_config.json'

配置完成后,重启 Claude Desktop 使配置生效。

基本使用方法

配置并启动 MCP 服务器后,在支持 MCP 协议的客户端中,您可以指示 LLM 使用 'search' 工具进行网页搜索或内容抓取。

例如,在 Claude Desktop 中,您可以向 Claude 提问:

请使用 search 工具搜索 "最新的大语言模型发展动态" 并总结要点。

Claude 将会识别 'search' 工具调用,并与 RAG Web Browser MCP 服务器交互,执行网页搜索,并将结果返回给您。

您也可以指示 Claude 抓取特定 URL 的内容,例如:

请使用 search 工具抓取 "https://www.example.com" 的内容并分析。

开发者调试

仓库提供了多种客户端示例 (example_client_stdio.ts, example_client_sse.ts, example_chat_stdio.ts) 和调试工具 (MCP Inspector),方便开发者进行本地测试和调试。具体使用方法请参考仓库 README 文档。

信息

分类

网页与API