Everything MCP Server

Servidor MCP para búsqueda de archivos en Everything (voidtools)

Documentación

Everything MCP Server

Un servidor MCP (Model Context Protocol) que integra la búsqueda de archivos de Everything con Claude Desktop. Busca en todo tu sistema de archivos de Windows al instante desde Claude.

Características

⚡ Búsqueda instantánea - Aprovecha el indexado ultrarrápido de archivos de Everything
🔍 Múltiples modos de búsqueda - Básica, filtrada, regex, por tipo, por atributos
📁 Operaciones de carpetas - Busca dentro de rutas específicas, encuentra carpetas vacías
📊 Estadísticas - Obtén recuentos de archivos y tamaños totales sin listar archivos
🕐 Archivos recientes - Encuentra archivos modificados recientemente
📋 Buscador de duplicados - Localiza archivos con el mismo nombre
💾 Exportación - Guarda resultados en txt, csv, json y más

Requisitos previos

Windows - Everything solo se ejecuta en Windows
Everything debe estar instalado y en ejecución
es.exe (línea de comandos de Everything) instalado
- Instalar desde: https://github.com/voidtools/es
- Debe estar en %LOCALAPPDATA%\Microsoft\WindowsApps

Instalación

Usando uvx (recomendado)

uvx mcp-everything-search

Usando pip

pip install mcp-everything-search

Configuración

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

Ubicación: %APPDATA%\Claude\claude_desktop_config.json

Usando uvx

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

Usando pip

{
  "mcpServers": {
    "everything-search": {
      "command": "python",
      "args": ["-m", "mcp_everything_search"]
    }
  }
}

Usuarios de Everything 1.5 Alpha

Si estás usando Everything 1.5 alpha, añade la variable de entorno EVERYTHING_INSTANCE:

{
  "mcpServers": {
    "everything-search": {
      "command": "uvx",
      "args": ["mcp-everything-search"],
      "env": {
        "EVERYTHING_INSTANCE": "1.5a"
      }
    }
  }
}

Luego reinicia Claude Desktop.

Herramientas Disponibles

Búsqueda Básica

Herramienta	Descripción
`search_files`	Búsqueda básica de archivos con comodines (`*`, `?`), opciones de ordenación
`search_with_filters`	Búsqueda con filtros de extensión, tamaño, ruta, solo archivos/carpetas
`search_regex`	Búsqueda usando expresiones regulares

Búsqueda Especializada

Herramienta	Descripción
`search_by_type`	Búsqueda por categoría: audio, video, imagen, documento, ejecutable, comprimido, código
`search_folders`	Encuentra solo directorios
`search_recent_files`	Encuentra archivos modificados recientemente
`search_duplicates`	Encuentra archivos con el mismo nombre
`search_by_attributes`	Filtra por ocultos, del sistema, solo lectura, comprimidos, cifrados
`search_empty_folders`	Encuentra directorios vacíos
`search_large_files`	Encuentra archivos por encima de un tamaño especificado

Utilidades

Herramienta	Descripción
`search_with_details`	Búsqueda con salida detallada (tamaño, fechas)
`get_result_count`	Obtén el recuento de coincidencias sin listar (rápido)
`get_total_size`	Obtén el tamaño total de todos los archivos coincidentes
`open_file_location`	Abre la carpeta contenedora en el Explorador
`get_file_info`	Obtén tamaño, fechas y detalles del archivo
`export_search_results`	Exporta a txt, csv, json, m3u, m3u8, tsv, efu

Consultas de Ejemplo

Pregunta a Claude cosas como:

"Encuentra todos los archivos Python en D:\Projects"
"Busca archivos PDF de más de 10mb"
"Encuentra imágenes modificadas en los últimos 3 días"
"Busca archivos duplicados llamados config.json"
"Encuentra todos los archivos de video en mi carpeta de Descargas"
"Busca archivos que coincidan con la regex test_.*\.py$"
"Encuentra carpetas vacías en D:\Archive"
"¿Cuál es el tamaño total de todos los archivos MP3?"
"¿Cuántos archivos JavaScript hay en este proyecto?"
"Encuentra archivos ocultos en C:\Windows"
"Exporta todos los archivos de registro a un CSV"

Opciones de Ordenación

Muchas herramientas admiten el parámetro sort_by:

name, path, size, extension
date-modified, date-created, date-accessed
Añade -descending para orden inverso (p. ej., size-descending)

Desarrollo

# Clone the repo
git clone https://github.com/essovius/mcp-everything-search.git
cd mcp-everything-search

# Create virtual environment
python -m venv venv
.\venv\Scripts\activate

# Install in development mode
pip install -e .

# Run the server
python -m mcp_everything_search

Licencia

Licencia MIT - consulta LICENSE para más detalles.

Agradecimientos

Everything de voidtools
Model Context Protocol de Anthropic