Local Research MCP Server

Un asistente de investigación privado y local que busca en la web y extrae contenido utilizando DuckDuckGo.

Documentación

Servidor MCP de Investigación Local

Un asistente de investigación gratuito y privado para entornos de desarrollo de IA que busca en la web y extrae contenido usando DuckDuckGo y Python. Este servidor MCP brinda a los asistentes de IA la capacidad de acceder a información en tiempo real mientras mantiene todo el procesamiento local para una privacidad completa.

Compatible con:

Claude Desktop - La aplicación de escritorio oficial de Anthropic
Claude Code - La herramienta CLI de Anthropic para desarrolladores
Gemini CLI - La herramienta CLI de Gemini
Cline - Extensión de VS Code para programación asistida por IA
Cualquier cliente compatible con MCP

Características

🔍 Búsqueda web gratuita: Utiliza la API de búsqueda de DuckDuckGo sin requerir claves API
📄 Extracción de contenido: Extrae inteligentemente texto limpio de páginas web
🔒 Privacidad primero: Todo el procesamiento ocurre localmente en tu máquina
⚡ Integración rápida: Funciona perfectamente con Claude Desktop a través de MCP
🛠️ Cero dependencias: Sin servicios externos ni suscripciones requeridas

Inicio rápido

Requisitos previos

Python 3.10 o superior
Uno de los entornos de IA compatibles:
- Claude Desktop, Claude Code, Google CLI, Cline u otro cliente MCP
Conocimientos básicos de línea de comandos

Instalación

Clona este repositorio:

git clone https://github.com/Unlock-MCP/local-research-server.git
cd local-research-server

Configura el entorno:

uv init
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Instala las dependencias:

uv add "mcp[cli]" duckduckgo-search trafilatura

Prueba el servidor:
```
python research_server.py
```

Configuración

Elige tu entorno de IA:

Claude Desktop

Añade esto a tu archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "local-researcher": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/local-research-server",
        "run",
        "python",
        "research_server.py"
      ]
    }
  }
}

Claude Code

Añade esto a tu archivo CLAUDE.md o usa la CLI:

claude --mcp-server local-researcher="uv --directory /path/to/your/local-research-server run python research_server.py"

Google AI Studio / Gemini CLI

Configura a través de la configuración de tu cliente MCP o variables de entorno.

Cline (VS Code)

Añade a la configuración del servidor MCP de Cline en la configuración de VS Code.

Reemplaza /path/to/your/local-research-server con la ruta completa a este directorio.

Uso

Después de la configuración, reinicia tu entorno de IA. Los indicadores de conexión varían según la plataforma:

Claude Desktop: Busca el ícono de enchufe (🔌)
Claude Code: El estado del servidor se muestra en la salida de la CLI
Otras plataformas: Verifica el estado de conexión de tu cliente MCP

Haz preguntas de investigación a tu asistente de IA como:

"¿Cuáles son los últimos avances en investigación de IA esta semana?"
"Investiga las tendencias actuales de energía renovable en Europa"
"Encuentra informes recientes de amenazas de ciberseguridad"

Tu asistente de IA usará automáticamente el servidor local para obtener información en tiempo real.

Cómo funciona

El servidor implementa una única herramienta MCP que:

Busca en la web usando la API gratuita de DuckDuckGo
Extrae contenido de los principales resultados de búsqueda
Procesa texto limpio y legible usando Trafilatura
Devuelve contenido formateado a Claude para su análisis

Todo el procesamiento ocurre localmente sin enviar datos a servicios externos, excepto las búsquedas web públicas.

Arquitectura

AI Client (Claude Desktop/Code/Gemini/Cline)
    ↓ (MCP Protocol)
Local Research Server
    ↓ (Search API)
DuckDuckGo Search
    ↓ (HTTP Requests)
Target Websites
    ↓ (Content Extraction)
Clean Text → AI Assistant

Opciones de configuración

El servidor acepta estos parámetros para la herramienta de investigación:

query (cadena): La consulta de búsqueda o tema de investigación
num_results (entero): Número de resultados de búsqueda a procesar (predeterminado: 3)

Características de seguridad

Validación de entrada: Sanea las consultas de búsqueda
Limitación de velocidad: Retrasos corteses entre solicitudes web
Manejo de errores: Manejo elegante de fallos
Procesamiento local: Sin dependencias de datos externos

Aplicaciones empresariales

Este servidor de investigación es ideal para:

Creación de contenido: Redacción de artículos respaldados por investigación
Análisis de mercado: Investigación en tiempo real de competidores e industria
Debida diligencia: Investigación de empresas e inversiones
Monitoreo regulatorio: Seguimiento de requisitos de cumplimiento

Extensión del servidor

Considera estas mejoras:

Añadir integración de feeds RSS
Implementar caché de resultados de búsqueda
Añadir capacidades de filtrado por dominio
Incluir extracción de fecha de publicación
Añadir soporte para múltiples motores de búsqueda

Solución de problemas

Problemas comunes

El servidor no se conecta:

Verifica la ruta absoluta en la configuración de tu cliente de IA
Reinicia completamente tu entorno de IA
Comprueba que las dependencias de Python estén instaladas

Sin resultados de búsqueda:

Verifica la conexión a internet
Comprueba el estado del servicio de DuckDuckGo
Prueba con diferentes consultas de búsqueda

Fallo en la extracción de contenido:

Algunos sitios web bloquean el scraping
Prueba con diferentes términos de búsqueda para fuentes variadas
Revisa la salida de la consola para errores específicos

Contribuciones

¡Agradecemos las contribuciones! Consulta nuestra Guía de contribución para más detalles.