Everything Search

Realiza búsquedas locales de archivos ultrarrápidas en Windows utilizando el motor de búsqueda Everything.

Documentación

Everything Search MCP Server

Un potente servidor de Model Context Protocol (MCP) que se integra con Everything Search Engine, proporcionando capacidades de búsqueda de archivos ultrarrápidas en todo tu sistema. Este servidor permite búsquedas de archivos en lenguaje natural y opciones de filtrado avanzadas a través de aplicaciones compatibles con MCP como Claude Desktop, VS Code y otros clientes MCP.

Características

🚀 Búsqueda Ultrarrápida: Aprovecha la indexación instantánea de archivos de Everything Search Engine
🔍 Consultas en Lenguaje Natural: Busca usando descripciones en lenguaje natural como "archivos de video grandes" o "documentos recientes"
🎯 Opciones de Búsqueda Avanzadas: Sensibilidad a mayúsculas, coincidencia de palabras completas, soporte de expresiones regulares
📁 Búsqueda por Ruta: Busca dentro de directorios específicos o en unidades completas
📊 Ordenación Inteligente: Ordena por nombre, ruta, tamaño o fecha de modificación
🎨 Formato Enriquecido: Tamaños de archivo legibles y fechas formateadas
🌐 Instalación Global: Instala una vez, usa en todas partes en todos los clientes MCP
⚡ Resultados en Tiempo Real: Resultados de búsqueda instantáneos mientras escribes
🔧 Altamente Configurable: Puertos, ámbitos y parámetros de búsqueda personalizables

Inicio Rápido

Requisitos Previos

Sistema Operativo Windows (Everything Search Engine es solo para Windows)
Node.js 16+ - Descargar aquí
Everything Search Engine - Descargar aquí

Paso 1: Instalar Everything Search Engine

Descarga e instala Everything Search Engine
Abre Everything Search
Ve a Herramientas > Opciones > Servidor HTTP
✅ Habilita Servidor HTTP
Configura el puerto en 8011 (predeterminado)
Haz clic en Aceptar y reinicia Everything

Paso 2: Instalar el Servidor MCP

Opción A: Instalación Global (Recomendada)

npm install -g everything-search-mcp-server

Nota: Si aún no has publicado en npm, los usuarios deben usar la Opción B (Desde el Código Fuente) hasta que el paquete esté disponible en npm.

Opción B: Desde el Código Fuente

git clone https://github.com/ananyaakamat/everything-search-mcp-server.git
cd everything-search-mcp-server
npm install
npm run build
npm install -g .

Paso 3: Configurar tu Cliente MCP

Para Claude Desktop

Agrega a tu claude_desktop_config.json:

{
  "mcpServers": {
    "everything-search": {
      "command": "everything-search-mcp-server",
      "args": []
    }
  }
}

Ubicaciones del Archivo de Configuración:

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

Para VS Code

Para una instalación rápida, usa uno de los botones de instalación con un clic a continuación...

Para instalación manual, agrega el siguiente bloque JSON a tu archivo de Configuración de Usuario (JSON) en VS Code. Puedes hacer esto presionando Ctrl + Shift + P y escribiendo Preferences: Open User Settings (JSON).

Opcionalmente, puedes agregarlo a un archivo llamado .vscode/mcp.json en tu espacio de trabajo. Esto te permitirá compartir la configuración con otros.

Ten en cuenta que la clave mcp es necesaria cuando se usa el archivo mcp.json.

Agrega a tu settings.json de VS Code:

{
  "mcp": {
    "servers": {
      "everything-search": {
        "command": "everything-search-mcp-server",
        "args": []
      }
    }
  }
}

Ubicaciones del Archivo de Configuración:

Windows: %APPDATA%\Code\User\settings.json
macOS: ~/Library/Application Support/Code/User/settings.json
Linux: ~/.config/Code/User/settings.json

Nota: Asegúrate de tener la extensión MCP instalada en VS Code para el soporte del servidor MCP.

Paso 4: Reiniciar tu Cliente MCP

Reinicia Claude Desktop o VS Code para cargar el nuevo servidor.

Paso 5: Verificar la Instalación

Prueba que el servidor esté funcionando:

# Check if the command is available
everything-search-mcp-server --help

# Or test with a simple search (if Everything is running)
# The server should start and respond to MCP requests

En tu cliente MCP, intenta una búsqueda simple como:

"Buscar archivos README"
"Encontrar todos los archivos .txt"
"Muéstrame archivos de video grandes"
"Encontrar documentos de Word recientes"

Uso

El servidor proporciona dos herramientas potentes:

1. `search` - Búsqueda Avanzada de Archivos

{
  "query": "search terms",
  "scope": "C:",
  "caseSensitive": false,
  "wholeWord": false,
  "regex": false,
  "path": false,
  "maxResults": 100,
  "sortBy": "name",
  "ascending": true
}

2. `natural_search` - Búsqueda en Lenguaje Natural

{
  "naturalQuery": "find all video files larger than 1GB",
  "maxResults": 50
}

Ejemplos

Búsquedas Básicas

// Find all PDF files
{
  "query": "*.pdf",
  "maxResults": 10
}

// Search for "readme" files
{
  "query": "readme",
  "maxResults": 5
}

Búsquedas Avanzadas

// Case-sensitive search in specific directory
{
  "query": "Config",
  "scope": "C:\\Users\\YourName\\AppData",
  "caseSensitive": true,
  "maxResults": 20
}

// Regex search for JavaScript files
{
  "query": ".*\\.(js|ts)$",
  "regex": true,
  "sortBy": "date_modified",
  "ascending": false
}

Búsquedas en Lenguaje Natural

// Find large video files
{
  "naturalQuery": "large video files on desktop",
  "maxResults": 10
}

// Find recent documents
{
  "naturalQuery": "documents modified this week",
  "maxResults": 15
}

// Find development projects
{
  "naturalQuery": "programming projects with package.json",
  "maxResults": 5
}

Referencia de Parámetros

Parámetros de la Herramienta `search`

Parámetro	Tipo	Predeterminado	Descripción
`query`	string	obligatorio	Cadena de consulta de búsqueda
`scope`	string	`"C:"`	Ámbito/directorio de búsqueda
`caseSensitive`	boolean	`false`	Habilita coincidencia sensible a mayúsculas
`wholeWord`	boolean	`false`	Coincidir solo palabras completas
`regex`	boolean	`false`	Habilita expresiones regulares
`path`	boolean	`false`	Buscar en rutas de archivo
`maxResults`	number	`100`	Resultados máximos (1-1000)
`sortBy`	string	`"name"`	Ordenar por: `name`, `path`, `size`, `date_modified`
`ascending`	boolean	`true`	Dirección de ordenación

Parámetros de la Herramienta `natural_search`

Parámetro	Tipo	Predeterminado	Descripción
`naturalQuery`	string	obligatorio	Descripción de búsqueda en lenguaje natural
`maxResults`	number	`100`	Resultados máximos (1-1000)

Solución de Problemas

Problemas Comunes

Error de "Conexión rechazada"
- Asegúrate de que Everything Search esté en ejecución
- Verifica que el Servidor HTTP esté habilitado (Herramientas > Opciones > Servidor HTTP)
- Comprueba que el puerto 8011 no esté bloqueado por el firewall
Error de "Comando no encontrado"
- Asegúrate de que el servidor esté instalado globalmente: npm install -g everything-search-mcp-server
- Verifica que Node.js esté en tu PATH
No se devuelven resultados
- Permite que Everything complete la indexación inicial (puede tomar unos minutos para unidades grandes)
- Comprueba primero si Everything puede encontrar archivos a través de su interfaz gráfica
- Verifica que tu ámbito de búsqueda exista y sea accesible
- Asegúrate de tener permisos de lectura para el directorio de búsqueda
Problemas de rendimiento
- Reduce maxResults para respuestas más rápidas
- Usa ámbitos de búsqueda más específicos para limitar el área de búsqueda
- Considera usar extensiones de archivo exactas en lugar de comodines

Configuración

Configuración de Puerto Personalizado

Si necesitas usar un puerto diferente:

Cambia el puerto HTTP de Everything (Herramientas > Opciones > Servidor HTTP)
Configura la variable de entorno: EVERYTHING_PORT=8012
O modifica el código fuente del servidor

Modo de Depuración

Habilita el registro de depuración:

DEBUG=everything-search:* everything-search-mcp-server

Novedades

Versión 1.0.0 🎉

Lanzamiento Inicial: Implementación completa del servidor MCP
Búsqueda en Lenguaje Natural: Consultas de búsqueda impulsadas por IA
Instalación Global: Instalación fácil basada en npm
Soporte Multi-Cliente: Funciona con Claude Desktop, VS Code y otros clientes MCP
Opciones de Búsqueda Avanzadas: Expresiones regulares, sensibilidad a mayúsculas, búsqueda por ruta
Documentación Completa: Guía integral de configuración y uso

Desarrollo

Compilación desde el Código Fuente

git clone https://github.com/ananyaakamat/everything-search-mcp-server.git
cd everything-search-mcp-server
npm install
npm run build

Ejecución de Pruebas

npm test

Contribuciones

Haz un fork del repositorio
Crea una rama de características: git checkout -b feature-name
Realiza tus cambios
Agrega pruebas si corresponde
Haz commit: git commit -am 'Add feature'
Haz push: git push origin feature-name
Crea una Solicitud de Extracción (Pull Request)

Licencia

Licencia ISC - consulta el archivo LICENSE para más detalles.

Soporte

🐛 Informes de Errores: GitHub Issues
💬 Discusiones: GitHub Discussions
📧 Correo Electrónico: anant.kamat.in@gmail.com

Proyectos Relacionados

Everything Search Engine - El potente motor de búsqueda de archivos con el que se integra este servidor
Model Context Protocol - El protocolo que implementa este servidor
Claude Desktop - Asistente de IA con soporte MCP

Hecho con ❤️ para la comunidad MCP

Everything Search

Documentación