Servidor de Protocolo de Contexto de Modelo (MCP) para el Actor del Navegador Web RAG 🌐

Implementación de un servidor MCP para el actor de navegador web RAG . Este actor funciona como navegador web para grandes modelos de lenguaje (LLM) y pipelines RAG, similar a una búsqueda web en ChatGPT.

🎯 ¿Qué hace este servidor MCP?

Este servidor está diseñado específicamente para proporcionar respuestas rápidas a agentes de IA y LLM, permitiéndoles interactuar con la web y extraer información de las páginas web. Se ejecuta localmente y se comunica con el actor del navegador web RAG en modo de espera , enviando consultas de búsqueda y recibiendo contenido web extraído como respuesta.

El actor del navegador web RAG permite que un asistente de IA:

• Realizar una búsqueda web, extraer las N URL principales de los resultados y devolver su contenido limpio como Markdown
• Obtener una única URL y devolver su contenido como Markdown

🧱 Componentes

Herramientas

• Búsqueda : Consulta la Búsqueda de Google, extrae las N URL principales de los resultados y devuelve su contenido limpio como Markdown. Argumentos:
  • query (cadena, obligatoria): término de búsqueda o URL
  • maxResults (número, opcional): número máximo de resultados de búsqueda a extraer (predeterminado: 1)
  • scrapingTool (cadena, opcional): Seleccione una herramienta de scraping para extraer páginas web. Opciones: 'browser-playwright' o 'raw-http' (predeterminado: 'raw-http')
  • outputFormats (matriz, opcional): Seleccione uno o más formatos de salida. Opciones: 'texto', 'markdown', 'html' (predeterminado: ['markdown'])
  • requestTimeoutSecs (número, opcional): tiempo máximo en segundos para la solicitud (predeterminado: 40)

🔄¿Qué es el Protocolo de Contexto Modelo?

El Protocolo de Contexto de Modelo (MCP) es un marco que permite que las aplicaciones de IA, como Claude Desktop, se conecten sin problemas con herramientas y fuentes de datos externas. Para más información, visite el sitio web del Protocolo de Contexto de Modelo o lea la entrada del blog "¿Qué es MCP y por qué es importante?" .

🤖 ¿Cómo se integra el servidor MCP con los agentes de IA?

El servidor MCP permite a los agentes de IA realizar búsquedas y navegar por la web mediante el actor de navegador web RAG . Para comprender mejor los agentes de IA, consulte nuestra entrada de blog: ¿Qué son los agentes de IA? y explore los agentes de Apify.

¿Te interesa crear y monetizar tu propio agente de IA en Apify? Consulta nuestra guía paso a paso para crear, publicar y monetizar agentes de IA en la plataforma Apify.

🔌 Servidores y clientes MCP relacionados de Apify

Este servidor opera con entrada/salida estándar (stdio), lo que proporciona una conexión directa con los agentes de IA. Apify ofrece otras herramientas relacionadas con MCP:

Opciones del servidor

• 🖥️ Este servidor MCP : un servidor local basado en stdio para integración directa con Claude Desktop
• Actor del navegador web RAG a través de SSE : acceda al navegador web RAG directamente a través de eventos enviados por el servidor sin ejecutar un servidor local
• 🇦 MCP Server Actor : servidor MCP que proporciona a los agentes de IA acceso a más de 4000 actores Apify especializados

Opciones del cliente

• 💬 Cliente Tester MCP : una interfaz de usuario fácil de usar para interactuar con cualquier servidor MCP basado en SSE

🛠️ Configuración

Prerrequisitos

• MacOS o Windows
• Se debe instalar la última versión de Claude Desktop (u otro cliente MCP)
• Node.js (v18 o superior)
• Token de API de Apify ( APIFY_TOKEN )

Instalar

Siga los pasos a continuación para configurar y ejecutar el servidor en su máquina local: Primero, clone el repositorio usando el siguiente comando:

Navegue al directorio del proyecto e instale las dependencias necesarias:

Antes de ejecutar el servidor, debes compilar el proyecto:

Escritorio de Claude

Configure Claude Desktop para reconocer el servidor MCP.

1. Abra la configuración de Claude Desktop y edite el siguiente archivo:
   • En macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • En 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" } } }
2. Reiniciar Claude Desktop
   • Salga completamente de Claude Desktop (asegúrese de que no esté simplemente minimizado o cerrado).
   • Reinicie Claude Desktop.
   • Busque el ícono 🔌 para confirmar que el servidor está conectado.
3. EjemplosPuedes pedirle a Claude que realice búsquedas en la web, como por ejemplo:
   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.

Depurar el servidor usando el Inspector MCP

👷🏼 Desarrollo

Cliente local (stdio)

Para probar el servidor localmente, puede utilizar example_client_stdio.ts :

El script iniciará el servidor MCP, buscará las herramientas disponibles y luego llamará a la herramienta search con una consulta.

Llamada directa a la API

Para probar la llamada directa al actor del navegador web RAG:

Depuración

Dado que los servidores MCP operan con la entrada/salida estándar (stdio), la depuración puede ser complicada. Para una mejor experiencia de depuración, utilice el Inspector MCP .

Construya el paquete mcp-server-rag-web-browser:

Puede iniciar el Inspector MCP a través de npm con este comando:

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.