Everything MCP Server

Everything MCP Server

Um servidor MCP (Model Context Protocol) que integra a busca de arquivos do Everything com o Claude Desktop. Pesquise em todo o seu sistema de arquivos Windows instantaneamente a partir do Claude.

Recursos

• ⚡ Busca instantânea - Aproveita a indexação de arquivos extremamente rápida do Everything
• 🔍 Vários modos de busca - Básica, filtrada, regex, por tipo, por atributos
• 📁 Operações de pasta - Pesquise em caminhos específicos, encontre pastas vazias
• 📊 Estatísticas - Obtenha contagens de arquivos e tamanhos totais sem listar arquivos
• 🕐 Arquivos recentes - Encontre arquivos modificados recentemente
• 📋 Localizador de duplicados - Localize arquivos com o mesmo nome
• 💾 Exportação - Salve resultados em txt, csv, json e mais

Pré-requisitos

1. Windows - O Everything só roda no Windows
2. Everything deve estar instalado e em execução
3. es.exe (linha de comando do Everything) instalado
   • Instale a partir de: https://github.com/voidtools/es
   • Deve estar em %LOCALAPPDATA%\Microsoft\WindowsApps

Instalação

Usando uvx (recomendado)

uvx mcp-everything-search

Usando pip

pip install mcp-everything-search

Configuração

Adicione isso ao seu arquivo de configuração do Claude Desktop:

Localização: %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"]
    }
  }
}

Usuários do Everything 1.5 Alpha

Se você estiver usando o Everything 1.5 alpha, adicione a variável de ambiente EVERYTHING_INSTANCE:

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

Em seguida, reinicie o Claude Desktop.

Ferramentas Disponíveis

Busca Básica

Ferramenta	Descrição
search_files	Busca básica de arquivos com curingas (*, ?), opções de ordenação
search_with_filters	Busca com filtros de extensão, tamanho, caminho, somente arquivos/pastas
search_regex	Busca usando expressões regulares

Busca Especializada

Ferramenta	Descrição
search_by_type	Busca por categoria: áudio, vídeo, imagem, documento, executável, compactado, código
search_folders	Encontre apenas diretórios
search_recent_files	Encontre arquivos modificados recentemente
search_duplicates	Encontre arquivos com o mesmo nome
search_by_attributes	Filtre por oculto, sistema, somente leitura, compactado, criptografado
search_empty_folders	Encontre diretórios vazios
search_large_files	Encontre arquivos acima de um tamanho especificado

Utilitários

Ferramenta	Descrição
search_with_details	Busca com saída detalhada (tamanho, datas)
get_result_count	Obtenha a contagem de correspondências sem listar (rápido)
get_total_size	Obtenha o tamanho total de todos os arquivos correspondentes
open_file_location	Abra a pasta contida no Explorer
get_file_info	Obtenha tamanho do arquivo, datas e detalhes
export_search_results	Exporte para txt, csv, json, m3u, m3u8, tsv, efu

Exemplos de Consultas

Pergunte ao Claude coisas como:

• "Encontre todos os arquivos Python em D:\Projects"
• "Pesquise arquivos PDF maiores que 10mb"
• "Encontre imagens modificadas nos últimos 3 dias"
• "Procure arquivos duplicados chamados config.json"
• "Encontre todos os arquivos de vídeo na minha pasta Downloads"
• "Pesquise arquivos que correspondam à regex test_.*\.py$"
• "Encontre pastas vazias em D:\Archive"
• "Qual é o tamanho total de todos os arquivos MP3?"
• "Quantos arquivos JavaScript existem neste projeto?"
• "Encontre arquivos ocultos em C:\Windows"
• "Exporte todos os arquivos de log para um CSV"

Opções de Ordenação

Muitas ferramentas suportam o parâmetro sort_by:

• name, path, size, extension
• date-modified, date-created, date-accessed
• Adicione -descending para ordem inversa (por exemplo, size-descending)

Desenvolvimento

# 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

Licença

Licença MIT - veja LICENSE para detalhes.

Agradecimentos

• Everything por voidtools
• Model Context Protocol por Anthropic