使用说明

项目简介

本项目是一个基于Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型（LLMs）提供网页浏览和信息检索能力。它通过集成 Apify RAG Web Browser Actor 作为后端服务，使得LLMs 可以执行网页搜索、抓取网页内容等操作，从而扩展 LLMs 的知识来源和应用场景。

主要功能点

网页搜索: 允许 LLM 通过关键词或URL进行网页搜索，底层使用 Google 搜索引擎。
内容抓取: 自动抓取搜索结果中排名靠前的网页或指定URL的网页内容。
Markdown格式: 返回经过清洗的网页内容，并以 Markdown 格式呈现，方便 LLM 理解和处理。
工具集成: 以 MCP 工具 (Tool) 的形式提供网页搜索和内容抓取功能，易于集成到支持 MCP 协议的 LLM 客户端，如 Claude Desktop。
Prompt 支持: 提供相应的 Prompt 模板，简化 LLM 调用和交互流程。

安装步骤

环境准备:
- 确保已安装 MacOS 或 Windows 操作系统。
- 确保已安装 Claude Desktop 最新版本 (或其他 MCP 客户端)。
- 确保已安装 Node.js (v18 或更高版本)。 Node.js 官网下载
- 注册并获取 Apify API Token。 Apify 平台获取 API Token 指引
下载代码: 从 GitHub 仓库 https://github.com/MCP-Mirror/apify_mcp-server-rag-web-browser 克隆代码到本地。
安装依赖: 在项目根目录下打开终端，运行命令 'npm install' 安装项目依赖。
构建项目: 运行命令 'npm run build' 编译 TypeScript 代码。

服务器配置

MCP 服务器需要配置到 MCP 客户端中才能使用，以 Claude Desktop 为例，配置方法如下：

编辑配置文件: 打开 Claude Desktop 的配置文件 'claude_desktop_config.json'。
- macOS 路径: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
- Windows 路径: '%APPDATA%/Claude/claude_desktop_config.json'

添加 MCP 服务器配置: 在 'mcpServers' 字段下添加 'mcp-server-rag-web-browser' 的配置，配置信息如下 (请根据实际代码仓库路径修改):

"mcpServers": {
  "mcp-server-rag-web-browser": {
    "command": "npx",
    "args": [
      "/path/to/apify_mcp-server-rag-web-browser/build/index.js"  //  请替换为你的代码仓库 build 目录下的 index.js 文件的绝对路径
    ],
    "env": {
       "APIFY_API_TOKEN": "YOUR_APIFY_API_TOKEN"  // 请替换为你的 Apify API Token
    }
  }
}

注意:

'"command": "npx"' 表示使用 'npx' 命令执行 JavaScript 文件。
'"args"' 数组中配置 MCP 服务器启动命令的参数，这里指向编译后的 'index.js' 文件路径。请务必替换 '/path/to/apify_mcp-server-rag-web-browser/build/index.js' 为你本地代码仓库中 'build/index.js' 文件的绝对路径。
'"env"' 字段配置环境变量，'APIFY_API_TOKEN' 用于调用 Apify RAG Web Browser Actor，请替换 'YOUR_APIFY_API_TOKEN' 为你自己的 Apify API Token。

重启 Claude Desktop: 完全退出 Claude Desktop (确保在任务栏或程序坞中也退出)，然后重新启动。
检查连接状态: 启动后，Claude Desktop 界面上通常会出现一个 🔌 图标，表示 MCP 服务器已连接成功。

基本使用方法

配置完成后，即可在 Claude Desktop 中指示 LLM 使用网页搜索功能。例如，你可以向 Claude 提问：

What is an MCP server and how can it be used?  (什么是 MCP 服务器，它有什么用途?)
What is an LLM, and what are the recent news updates? (什么是 LLM，最近有什么新闻?)
Find and analyze recent research papers about LLMs. (查找并分析最近关于 LLM 的研究论文。)

LLM 客户端会将这些请求转换为 MCP 协议的工具调用或 Prompt 请求，并发送给 'mcp-server-rag-web-browser' 服务器处理，最终将网页搜索结果返回给 LLM。

关键词