MCP Web Research Server

Servidor MCP Web Research

Un servidor de Model Context Protocol (MCP) para investigación web.

Lleva información en tiempo real a Claude e investiga fácilmente cualquier tema.

Características

• Integración con la búsqueda de Google
• Extracción de contenido de páginas web
• Seguimiento de sesiones de investigación (lista de páginas visitadas, consultas de búsqueda, etc.)
• Captura de pantallas

Requisitos previos

• Node.js >= 18 (incluye npm y npx)
• Aplicación Claude Desktop

Instalación

Primero, asegúrate de haber descargado e instalado la aplicación Claude Desktop y de tener npm instalado.

A continuación, añade esta entrada a tu claude_desktop_config.json (en Mac, se encuentra en ~/Library/Application\ Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "webresearch": {
      "command": "npx",
      "args": ["-y", "@mzxrai/mcp-webresearch@latest"]
    }
  }
}

Esta configuración permite que Claude Desktop inicie automáticamente el servidor MCP de investigación web cuando sea necesario.

Uso

Simplemente inicia un chat con Claude y envía un mensaje que se beneficie de la investigación web. Si deseas un mensaje predefinido personalizado para una investigación web más profunda, puedes usar el mensaje agentic-research que proporcionamos a través de este paquete. Accede a ese mensaje en Claude Desktop haciendo clic en el ícono de Clip en la entrada del chat y luego seleccionando Choose an integration → webresearch → agentic-research.

Herramientas

1. search_google

   • Realiza búsquedas en Google y extrae resultados
   • Argumentos: { query: string }

2. visit_page

   • Visita una página web y extrae su contenido
   • Argumentos: { url: string, takeScreenshot?: boolean }

3. take_screenshot

   • Toma una captura de pantalla de la página actual
   • No requiere argumentos

Mensajes

agentic-research

Un mensaje de investigación guiada que ayuda a Claude a realizar una investigación web exhaustiva. El mensaje instruye a Claude a:

• Comenzar con búsquedas amplias para comprender el panorama del tema
• Priorizar fuentes de alta calidad y autoridad
• Refinar iterativamente la dirección de la investigación según los hallazgos
• Mantenerte informado y permitirte guiar la investigación de forma interactiva
• Citar siempre las fuentes con URLs

Recursos

Exponemos dos cosas como recursos MCP: (1) capturas de pantalla de páginas web, y (2) la sesión de investigación.

Capturas de pantalla

Cuando tomas una captura de pantalla, se guarda como un recurso MCP. Puedes acceder a las capturas guardadas en Claude Desktop mediante el ícono de Clip.

Sesión de investigación

El servidor mantiene una sesión de investigación que incluye:

• Consultas de búsqueda
• Páginas visitadas
• Contenido extraído
• Capturas de pantalla
• Marcas de tiempo

Sugerencias

Para obtener los mejores resultados, si decides no usar el mensaje agentic-research al realizar tu investigación, puede ser útil sugerir fuentes de alta calidad para que Claude las use al investigar temas generales. Por ejemplo, podrías indicar news today from reuters or AP en lugar de news today.

Problemas

Este es código muy preliminar. Y también es AIGC, así que espera errores.

Si encuentras problemas, puede ser útil revisar los registros MCP de Claude Desktop:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Desarrollo

# Install dependencies
pnpm install

# Build the project
pnpm build

# Watch for changes
pnpm watch

# Run in development mode
pnpm dev

Requisitos

• Node.js >= 18
• Playwright (instalado automáticamente como dependencia)

Plataformas verificadas

• macOS
• Linux

Licencia

MIT

Autor

mzxrai