Everything Search

Servidor MCP de Everything Search

Un servidor MCP que proporciona capacidades rápidas de búsqueda de archivos en Windows, macOS y Linux. En Windows, utiliza el SDK de Everything. En macOS, utiliza el comando integrado mdfind. En Linux, utiliza el comando locate/plocate.

Herramientas

search

Busca archivos y carpetas en todo tu sistema. Las capacidades y la sintaxis de búsqueda varían según la plataforma:

• Windows: Funciones completas del SDK de Everything (consulta la guía de sintaxis a continuación)
• macOS: Búsqueda básica de nombres de archivo y contenido mediante la base de datos de Spotlight
• Linux: Búsqueda básica de nombres de archivo mediante la base de datos de locate

Parámetros:

• query (obligatorio): Cadena de consulta de búsqueda. Consulta las notas específicas de cada plataforma a continuación.
• max_results (opcional): Número máximo de resultados a devolver (predeterminado: 100, máximo: 1000)
• match_path (opcional): Coincidir con la ruta completa en lugar de solo con el nombre de archivo (predeterminado: false)
• match_case (opcional): Habilitar búsqueda sensible a mayúsculas y minúsculas (predeterminado: false)
• match_whole_word (opcional): Coincidir solo palabras completas (predeterminado: false)
• match_regex (opcional): Habilitar búsqueda con expresiones regulares (predeterminado: false)
• sort_by (opcional): Orden de clasificación de los resultados (predeterminado: 1). Opciones disponibles:

  - 1: Sort by filename (A to Z)
  - 2: Sort by filename (Z to A)
  - 3: Sort by path (A to Z)
  - 4: Sort by path (Z to A)
  - 5: Sort by size (smallest first)
  - 6: Sort by size (largest first)
  - 7: Sort by extension (A to Z)
  - 8: Sort by extension (Z to A)
  - 11: Sort by creation date (oldest first)
  - 12: Sort by creation date (newest first)
  - 13: Sort by modification date (oldest first)
  - 14: Sort by modification date (newest first)

Ejemplos:

{
  "query": "*.py",
  "max_results": 50,
  "sort_by": 6
}

{
  "query": "ext:py datemodified:today",
  "max_results": 10
}

La respuesta incluye:

• Ruta del archivo/carpeta
• Tamaño del archivo en bytes
• Fecha de última modificación

Guía de sintaxis de búsqueda

Para obtener información detallada sobre la sintaxis de búsqueda compatible en cada plataforma (Windows, macOS y Linux), consulta SEARCH_SYNTAX.md.

Requisitos previos

Windows

1. Utilidad de búsqueda Everything:
   • Descárgala e instálala desde https://www.voidtools.com/
   • Asegúrate de que el servicio de Everything esté en ejecución
2. SDK de Everything:
   • Descárgalo desde https://www.voidtools.com/support/everything/sdk/
   • Extrae los archivos del SDK a una ubicación en tu sistema

Linux

1. Instala e inicializa el comando locate o plocate:
   • Ubuntu/Debian: sudo apt-get install plocate o sudo apt-get install mlocate
   • Fedora: sudo dnf install mlocate
2. Después de la instalación, actualiza la base de datos:
   • Para plocate: sudo updatedb
   • Para mlocate: sudo /etc/cron.daily/mlocate

macOS

No se requiere configuración adicional. El servidor utiliza el comando integrado mdfind.

Instalación

Instalación mediante Smithery

Para instalar Everything Search para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install mcp-server-everything-search --client claude

Usando uv (recomendado)

Cuando se usa uv no se necesita una instalación específica. Usaremos uvx para ejecutar directamente mcp-server-everything-search.

Usando PIP

Alternativamente, puedes instalar mcp-server-everything-search mediante pip:

pip install mcp-server-everything-search

Después de la instalación, puedes ejecutarlo como un script usando:

python -m mcp_server_everything_search

Configuración

Windows

El servidor requiere que la DLL del SDK de Everything esté disponible:

Variable de entorno:

EVERYTHING_SDK_PATH=path\to\Everything-SDK\dll\Everything64.dll

Linux y macOS

No se requiere configuración adicional.

Uso con Claude Desktop

Agrega una de estas configuraciones a tu claude_desktop_config.json según tu plataforma:

"mcpServers": {
  "everything-search": {
    "command": "uvx",
    "args": ["mcp-server-everything-search"],
    "env": {
      "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
    }
  }
}

"mcpServers": {
  "everything-search": {
    "command": "python",
    "args": ["-m", "mcp_server_everything_search"],
    "env": {
      "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
    }
  }
}

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

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

Depuración

Puedes usar el inspector de MCP para depurar el servidor. Para instalaciones con uvx:

npx @modelcontextprotocol/inspector uvx mcp-server-everything-search

O si has instalado el paquete en un directorio específico o estás desarrollando en él:

git clone https://github.com/mamertofabian/mcp-everything-search.git
cd mcp-everything-search/src/mcp_server_everything_search
npx @modelcontextprotocol/inspector uv run mcp-server-everything-search

Para ver los registros del servidor:

Linux/macOS:

tail -f ~/.config/Claude/logs/mcp*.log

Windows (PowerShell):

Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -Wait

Desarrollo

Si estás realizando desarrollo local, hay dos formas de probar tus cambios:

1. Ejecuta el inspector de MCP para probar tus cambios. Consulta Depuración para obtener instrucciones de ejecución.

2. Prueba usando la aplicación de escritorio de Claude. Agrega lo siguiente a tu claude_desktop_config.json:

"everything-search": {
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/mcp-everything-search/src/mcp_server_everything_search",
    "run",
    "mcp-server-everything-search"
  ],
  "env": {
    "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
  }
}

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.

Aviso legal

Este proyecto no está afiliado, respaldado ni patrocinado por voidtools (los creadores de la utilidad de búsqueda Everything). Este es un proyecto independiente que utiliza el SDK de Everything disponible públicamente.