MCP Deep Web Research Server
Servidor de investigación web profunda MCP (v0.3.0)
Un servidor de Protocolo de Contexto Modelo (MCP) para investigación web avanzada.
Últimos cambios
Se agregó la herramienta visit_page para la extracción directa de contenido de la página web
Rendimiento optimizado para trabajar dentro de los límites de tiempo de espera de MCP
Parámetros maxDepth y maxBranching predeterminados reducidos
Eficiencia de carga de páginas mejorada
Se agregaron controles de tiempo de espera durante todo el proceso.
Manejo mejorado de errores en tiempos de espera
Este proyecto es una bifurcación de mcp-webresearch de mzxrai , mejorada con funciones adicionales para la investigación en la web profunda. Agradecemos a los creadores originales su labor fundacional.
Incorpore información en tiempo real a Claude con colas de búsqueda inteligentes, extracción de contenido mejorada y capacidades de investigación profunda.
Related MCP server: MCP Web Research Server
Características
Sistema de cola de búsqueda inteligente
Operaciones de búsqueda por lotes con limitación de velocidad
Gestión de colas con seguimiento del progreso
Recuperación de errores y reintentos automáticos
Desduplicación de resultados de búsqueda
Extracción de contenido mejorada
Puntuación de relevancia basada en TF-IDF
Análisis de proximidad de palabras clave
Ponderación de la sección de contenido
Puntuación de legibilidad
Análisis mejorado de la estructura HTML
Extracción de datos estructurados
Mejor limpieza y formato de contenido
Características principales
Integración de búsqueda de Google
Extracción de contenido de páginas web
Seguimiento de sesiones de investigación
Conversión de Markdown con formato mejorado
Prerrequisitos
Node.js >= 18 (incluye
npmynpx)
Instalación
Instalación mediante herrería
Para instalar Deep Web Research Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @PedroDnT/mcp-deepwebresearch --client claudeInstalación global (recomendada)
# Install globally using npm
npm install -g mcp-deepwebresearch
# Or using yarn
yarn global add mcp-deepwebresearch
# Or using pnpm
pnpm add -g mcp-deepwebresearchInstalación de proyecto local
# Using npm
npm install mcp-deepwebresearch
# Using yarn
yarn add mcp-deepwebresearch
# Using pnpm
pnpm add mcp-deepwebresearchIntegración de escritorio de Claude
Después de instalar el paquete, agregue esta entrada a su claude_desktop_config.json :
Ventanas
{
"mcpServers": {
"deepwebresearch": {
"command": "mcp-deepwebresearch",
"args": []
}
}
}Ubicación: %APPDATA%\Claude\claude_desktop_config.json
macOS
{
"mcpServers": {
"deepwebresearch": {
"command": "mcp-deepwebresearch",
"args": []
}
}
}Ubicación: ~/Library/Application Support/Claude/claude_desktop_config.json
Esta configuración permite que Claude Desktop inicie automáticamente el servidor de investigación web MCP cuando sea necesario.
Configuración por primera vez
Después de la instalación, ejecute este comando para instalar las dependencias necesarias del navegador:
npx playwright install chromiumUso
Simplemente inicia un chat con Claude y envía una propuesta que se beneficie de una investigación web. Si deseas una propuesta prediseñada y personalizada para una investigación web más profunda, puedes usar la propuesta agentic-research que ofrecemos en este paquete. Accede a esa propuesta en Claude Desktop haciendo clic en el icono del clip en la entrada del chat y seleccionando " Choose an integration → deepwebresearch → agentic-research .
Herramientas
deep_researchRealiza una investigación exhaustiva con análisis de contenido.
Argumentos:
{ topic: string; maxDepth?: number; // default: 2 maxBranching?: number; // default: 3 timeout?: number; // default: 55000 (55 seconds) minRelevanceScore?: number; // default: 0.7 }Devoluciones:
{ findings: { mainTopics: Array<{name: string, importance: number}>; keyInsights: Array<{text: string, confidence: number}>; sources: Array<{url: string, credibilityScore: number}>; }; progress: { completedSteps: number; totalSteps: number; processedUrls: number; }; timing: { started: string; completed?: string; duration?: number; operations?: { parallelSearch?: number; deduplication?: number; topResultsProcessing?: number; remainingResultsProcessing?: number; total?: number; }; }; }
parallel_searchRealiza múltiples búsquedas de Google en paralelo con cola inteligente
Argumentos:
{ queries: string[], maxParallel?: number }Nota: maxParallel está limitado a 5 para garantizar un rendimiento confiable
visit_pageVisita una página web y extrae su contenido
Argumentos:
{ url: string }Devoluciones:
{ url: string; title: string; content: string; // Markdown formatted content }
Indicaciones
agentic-research
Una guía de investigación que ayuda a Claude a realizar una investigación web exhaustiva. La guía le indica a Claude que:
Comience con búsquedas amplias para comprender el panorama temático.
Priorizar fuentes confiables y de alta calidad
Refinar iterativamente la dirección de la investigación en función de los hallazgos
Manténgase informado y permítanos guiar la investigación de forma interactiva.
Cite siempre las fuentes con URL
Opciones de configuración
El servidor se puede configurar a través de variables de entorno:
MAX_PARALLEL_SEARCHES: Número máximo de búsquedas simultáneas (predeterminado: 5)SEARCH_DELAY_MS: Retraso entre búsquedas en milisegundos (valor predeterminado: 200)MAX_RETRIES: Número de reintentos para solicitudes fallidas (valor predeterminado: 3)TIMEOUT_MS: Tiempo de espera de la solicitud en milisegundos (valor predeterminado: 55000)LOG_LEVEL: Nivel de registro (predeterminado: 'info')
Manejo de errores
Problemas comunes
Limitación de velocidad
Síntoma: Error "Demasiadas solicitudes"
Solución: Aumente
SEARCH_DELAY_MSo disminuyaMAX_PARALLEL_SEARCHES
Tiempos de espera de la red
Síntoma: Error "Tiempo de espera agotado"
Solución: Asegúrese de que las solicitudes se completen dentro del tiempo de espera de MCP de 60 segundos
Problemas con el navegador
Síntoma: Error "No se pudo iniciar el navegador"
Solución: asegúrese de que Playwright esté instalado correctamente (
npx playwright install)
Depuración
Este software es beta. Si tiene algún problema:
Consulte los registros MCP de Claude Desktop:
# On macOS tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # On Windows Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -WaitHabilitar el registro de depuración:
export LOG_LEVEL=debug
Desarrollo
Configuración
# Install dependencies
pnpm install
# Build the project
pnpm build
# Watch for changes
pnpm watch
# Run in development mode
pnpm devPruebas
# Run all tests
pnpm test
# Run tests in watch mode
pnpm test:watch
# Run tests with coverage
pnpm test:coverageCalidad del código
# Run linter
pnpm lint
# Fix linting issues
pnpm lint:fix
# Type check
pnpm type-checkContribuyendo
Bifurcar el repositorio
Crea tu rama de funciones (
git checkout -b feature/amazing-feature)Confirme sus cambios (
git commit -m 'Add some amazing feature')Empujar a la rama (
git push origin feature/amazing-feature)Abrir una solicitud de extracción
Estándares de codificación
Siga las mejores prácticas de TypeScript
Mantener la cobertura de pruebas por encima del 80%
Documentar nuevas funciones y API
Actualice CHANGELOG.md para cambios significativos
Seguir el versionado semántico
Consideraciones de rendimiento
Utilice operaciones por lotes siempre que sea posible
Implementar un manejo adecuado de errores y reintentos
Considere el uso de memoria con grandes conjuntos de datos
Almacenar en caché los resultados cuando sea apropiado
Utilice la transmisión para contenido de gran tamaño
Requisitos
Node.js >= 18
Dramaturgo (instalado automáticamente como dependencia)
Plataformas verificadas
[x] macOS
[x] Ventanas
[ ] Linux
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Créditos
Este proyecto se basa en el excelente trabajo de mcp-webresearch de mzxrai . El código base original sentó las bases para nuestras funciones y capacidades mejoradas.
Autor
Available Tools
3 toolsdeep_researchC
Perform deep research on a topic with content extraction and analysis
Inputs: topic (required), maxDepth, maxBranching, timeout, +1 more.
parallel_searchC
Perform multiple Google searches in parallel
Inputs: queries (required), maxParallel.
visit_pageC
Visit a webpage and extract its content
Inputs: url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: deep_research focuses on comprehensive topic analysis, parallel_search handles multiple Google searches, and visit_page extracts content from specific webpages. There is no overlap in functionality, making tool selection straightforward for an agent.
The naming is mixed: deep_research and parallel_search use snake_case with descriptive names, while visit_page also uses snake_case but is more action-oriented. There is no consistent verb_noun pattern, but the names are still readable and understandable.
With only 3 tools, the server feels thin for a 'Deep Web Research' scope, which might imply more comprehensive capabilities like data analysis or report generation. However, the tools cover core search and extraction tasks, so it's borderline but not severely lacking.
The tools cover basic web research tasks (searching, visiting, deep analysis), but there are notable gaps such as no tools for saving results, managing research sessions, or advanced data processing. Agents can work around this, but the surface is not fully comprehensive for deep web research.
Maintenance
Related MCP Connectors
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Hosted DataForSEO MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Web search API and MCP server for developers building AI agents.
Related MCP Servers
- AlicenseBqualityFmaintenanceA Model Context Protocol (MCP) server for web research. Bring real-time info into Claude and easily research any topic.3301MIT
- AlicenseBqualityDmaintenanceThe MCP Web Research Server enables real-time web research with Claude by integrating Google search, capturing webpage content and screenshots, and tracking research sessions.388MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables Claude to perform web research by integrating Google search, extracting webpage content, and capturing screenshots.320MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables Claude to perform web research by integrating Google search, extracting webpage content, and capturing screenshots in real-time.410MIT