Everything Search

Servidor MCP Everything Search

Um servidor MCP que fornece capacidades rápidas de busca de arquivos em Windows, macOS e Linux. No Windows, ele usa o SDK do Everything. No macOS, ele usa o comando integrado mdfind. No Linux, ele usa o comando locate/plocate.

Ferramentas

search

Busque por arquivos e pastas em todo o seu sistema. As capacidades e a sintaxe de busca variam conforme a plataforma:

• Windows: Recursos completos do SDK do Everything (veja o guia de sintaxe abaixo)
• macOS: Busca básica por nome de arquivo e conteúdo usando o banco de dados do Spotlight
• Linux: Busca básica por nome de arquivo usando o banco de dados do locate

Parâmetros:

• query (obrigatório): String da consulta de busca. Veja as notas específicas por plataforma abaixo.
• max_results (opcional): Número máximo de resultados a retornar (padrão: 100, máximo: 1000)
• match_path (opcional): Buscar no caminho completo em vez de apenas no nome do arquivo (padrão: falso)
• match_case (opcional): Ativar busca sensível a maiúsculas/minúsculas (padrão: falso)
• match_whole_word (opcional): Buscar apenas palavras inteiras (padrão: falso)
• match_regex (opcional): Ativar busca com regex (padrão: falso)
• sort_by (opcional): Ordem de classificação dos resultados (padrão: 1). Opções disponíveis:

  - 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)

Exemplos:

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

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

A resposta inclui:

• Caminho do arquivo/pasta
• Tamanho do arquivo em bytes
• Data da última modificação

Guia de Sintaxe de Busca

Para informações detalhadas sobre a sintaxe de busca suportada em cada plataforma (Windows, macOS e Linux), consulte SEARCH_SYNTAX.md.

Pré-requisitos

Windows

1. Utilitário de busca Everything:
   • Baixe e instale a partir de https://www.voidtools.com/
   • Certifique-se de que o serviço do Everything esteja em execução
2. SDK do Everything:
   • Baixe a partir de https://www.voidtools.com/support/everything/sdk/
   • Extraia os arquivos do SDK para um local no seu sistema

Linux

1. Instale e inicialize o comando locate ou plocate:
   • Ubuntu/Debian: sudo apt-get install plocate ou sudo apt-get install mlocate
   • Fedora: sudo dnf install mlocate
2. Após a instalação, atualize o banco de dados:
   • Para plocate: sudo updatedb
   • Para mlocate: sudo /etc/cron.daily/mlocate

macOS

Nenhuma configuração adicional é necessária. O servidor usa o comando integrado mdfind.

Instalação

Instalando via Smithery

Para instalar o Everything Search para Claude Desktop automaticamente via Smithery:

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

Usando uv (recomendado)

Ao usar uv, nenhuma instalação específica é necessária. Usaremos uvx para executar diretamente o mcp-server-everything-search.

Usando PIP

Alternativamente, você pode instalar o mcp-server-everything-search via pip:

pip install mcp-server-everything-search

Após a instalação, você pode executá-lo como um script usando:

python -m mcp_server_everything_search

Configuração

Windows

O servidor requer que a DLL do SDK do Everything esteja disponível:

Variável de ambiente:

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

Linux e macOS

Nenhuma configuração adicional é necessária.

Uso com Claude Desktop

Adicione uma destas configurações ao seu claude_desktop_config.json com base na sua 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"]
  }
}

Depuração

Você pode usar o inspetor MCP para depurar o servidor. Para instalações via uvx:

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

Ou, se você instalou o pacote em um diretório específico ou está desenvolvendo nele:

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 visualizar os logs do servidor:

Linux/macOS:

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

Windows (PowerShell):

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

Desenvolvimento

Se você está fazendo desenvolvimento local, há duas maneiras de testar suas alterações:

1. Execute o inspetor MCP para testar suas alterações. Consulte Depuração para instruções de execução.

2. Teste usando o aplicativo de desktop do Claude. Adicione o seguinte ao seu 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"
  }
}

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você está livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.

Aviso Legal

Este projeto não é afiliado, endossado ou patrocinado pela voidtools (os criadores do utilitário de busca Everything). Este é um projeto independente que utiliza o SDK público do Everything.