# mcp-server-rag-web-browser

> MCP Server

This repository implements an MCP server for the RAG Web Browser Actor, enabling fast web interaction for AI agents by sending search queries and receiving extracted web content.

## Overview

- **Category:** AI
- **Language:** JavaScript
- **Stars:** 208
- **Forks:** 7
- **Owner:** apify
- **GitHub:** https://github.com/apify/mcp-server-rag-web-browser
- **Homepage:** https://apify.com/apify/rag-web-browser
- **Created:** 2024-12-06T14:57:51+00:00
- **Updated:** 2025-03-28T19:53:23+00:00
- **Source:** https://model-context-protocol.com/servers/mcp-server-rag-web-browser-actor

## Setup

## Setup

### Prerequisites

- MacOS or Windows
- The latest version of Claude Desktop must be installed (or another MCP client)
- [Node.js](https://nodejs.org/en) (v18 or higher)
- [Apify API Token](https://docs.apify.com/platform/integrations/api#api-token) (`APIFY_TOKEN`)

### Install

Follow the steps below to set up and run the server on your local machine:
First, clone the repository using the following command:

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

Navigate to the project directory and install the required dependencies:

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

Before running the server, you need to build the project:

```bash
npm run build
```

#### Claude Desktop

Configure Claude Desktop to recognize the MCP server.

1. Open your Claude Desktop configuration and edit the following file:

   - On macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
   - On Windows: `%APPDATA%/Claude/claude_desktop_config.json`

    ```text
    "mcpServers": {
      "rag-web-browser": {
        "command": "npx",
        "args": [
          "@apify/mcp-server-rag-web-browser"
        ],
        "env": {
           "APIFY_TOKEN": "your-apify-api-token"
        }
      }
    }
    ```

2. Restart Claude Desktop

    - Fully quit Claude Desktop (ensure it's not just minimized or closed).
    - Restart Claude Desktop.
    - Look for the 🔌 icon to confirm that the server is connected.

3. Examples

    You can ask Claude to perform web searches, such as:
    ```text
    What is an MCP server and how can it be used?
    What is an LLM, and what are the recent news updates?
    Find and analyze recent research papers about LLMs.
    ```

Debug the server using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector)
```bash
export APIFY_TOKEN=your-apify-api-token
npx @modelcontextprotocol/inspector npx -y @apify/mcp-server-rag-web-browser
```

## Tools

## Available Tools

1.  **search**: Query Google Search, scrape the top N URLs from the results, and returns their cleaned content as Markdown.