MCP Deep Search

MCP Deep Search

Servidor MCP para búsqueda profunda en la web usando @just-every/search. Busca en múltiples proveedores, incluyendo Google, Bing, Brave, DuckDuckGo, Perplexity y más.

Inicio Rápido

1. Crea o usa un archivo de entorno

Opción A: Crea un nuevo archivo .llm.env en tu directorio personal:

# Download example env file
curl -o ~/.llm.env https://raw.githubusercontent.com/just-every/mcp-deep-search/main/.env.example

# Edit with your API keys
nano ~/.llm.env

Opción B: Usa un archivo .env existente (debe usar una ruta absoluta):

# Example: /Users/yourname/projects/myproject/.env
# Example: /home/yourname/workspace/.env

2. Instalación

Claude Code

# Using ~/.llm.env
claude mcp add deep-search -s user -e ENV_FILE=$HOME/.llm.env -- npx -y @just-every/mcp-deep-search

# Using existing .env file (absolute path required)
claude mcp add deep-search -s user -e ENV_FILE=/absolute/path/to/your/.env -- npx -y @just-every/mcp-deep-search

# For debugging, check if ENV_FILE is being passed correctly:
claude mcp list

Otros clientes MCP

Añade a tu configuración de MCP:

{
  "mcpServers": {
    "deep-search": {
      "command": "npx",
      "args": ["-y", "@just-every/mcp-deep-search"],
      "env": {
        "ENV_FILE": "/path/to/.llm.env"
      }
    }
  }
}

Herramientas MCP

deep_search

Realiza búsquedas web usando un proveedor específico.

Parámetros:

• query (obligatorio): La consulta de búsqueda
• provider: Proveedor de búsqueda (predeterminado: brave)
• maxResults: Número máximo de resultados (predeterminado: 10)
• includeAnswer: Incluir respuesta de IA si está disponible (predeterminado: false)

comprehensive_research

Realiza investigaciones exhaustivas usando agentes de IA que seleccionan y consultan inteligentemente múltiples motores de búsqueda.

Parámetros:

• query (obligatorio): El tema de investigación
• modelClass: Clase de modelo de IA (predeterminado: reasoning_mini)

Proveedores de búsqueda

Proveedor	Clave de API requerida	Descripción
brave	BRAVE_API_KEY	Búsqueda centrada en la privacidad con resultados estructurados
anthropic	ANTHROPIC_API_KEY	Investigación profunda de múltiples pasos
openai	OPENAI_API_KEY	Búsqueda contextual de nivel ChatGPT
google	GOOGLE_API_KEY	Búsqueda con fundamentación de Gemini
sonar / sonar-pro	OPENROUTER_API_KEY	Variantes de búsqueda de Perplexity
xai	XAI_API_KEY	Búsqueda en tiempo real de Grok

Uso desde CLI

# Basic search
mcp-deep-search search "your query"

# Search with specific provider
mcp-deep-search search "your query" -p brave

# Get more results
mcp-deep-search search "your query" -n 20

Solución de problemas

El servidor MCP muestra "Failed" en Claude

Si ves "deep-search ✘ failed" en Claude, revisa estos problemas comunes:

1. Claves de API faltantes: El problema más común es la falta de claves de API. Verifica que tu ENV_FILE esté configurado correctamente:

   # Test if ENV_FILE is working
   ENV_FILE=/path/to/your/.env npx @just-every/mcp-deep-search search "test"
   

2. Comando de instalación incorrecto: Asegúrate de usar -e para las variables de entorno:

   # Correct - environment variable passed with -e flag before --
   claude mcp add deep-search -s user -e ENV_FILE=$HOME/.llm.env -- npx -y @just-every/mcp-deep-search
   
   # Incorrect - trying to pass as argument
   claude mcp add deep-search -s user -- npx -y @just-every/mcp-deep-search --env ENV_FILE=$HOME/.llm.env
   

3. Problemas de ruta: ENV_FILE debe usar rutas absolutas:

   # Good
   ENV_FILE=/Users/yourname/.llm.env
   ENV_FILE=$HOME/.llm.env
   
   # Bad
   ENV_FILE=.env
   ENV_FILE=~/.llm.env  # ~ not expanded in some contexts
   

4. Verifica la instalación: Revisa tu configuración de MCP:

   claude mcp list
   

5. Modo de depuración: Para mensajes de error detallados, ejecuta manualmente:

   ENV_FILE=/path/to/.env npx @just-every/mcp-deep-search
   

Obtención de claves de API

• Brave: brave.com/search/api
• Anthropic: console.anthropic.com
• OpenAI: platform.openai.com
• Google: makersuite.google.com
• OpenRouter: openrouter.ai
• xAI: x.ai

Función de reinicio automático

El servidor MCP incluye capacidad de reinicio automático por defecto para mayor fiabilidad:

• Reinicia automáticamente el servidor si se bloquea
• Maneja excepciones no capturadas y rechazos de promesas
• Implementa retroceso exponencial (máximo 10 intentos en 1 minuto)
• Registra todos los intentos de reinicio para monitoreo
• Maneja correctamente las señales de apagado (SIGINT, SIGTERM)

Para desarrollo/depuración sin reinicio automático:

# Run directly without restart wrapper
npm run serve:dev

Licencia

MIT © Just Every