Everything Search

Realize pesquisas locais de arquivos extremamente rápidas no Windows usando o Everything Search Engine.

Documentação

Servidor MCP Everything Search

Um poderoso servidor Model Context Protocol (MCP) que se integra ao Everything Search Engine, fornecendo recursos de busca de arquivos extremamente rápidos em todo o seu sistema. Este servidor permite buscas de arquivos em linguagem natural e opções avançadas de filtragem por meio de aplicativos compatíveis com MCP, como Claude Desktop, VS Code e outros clientes MCP.

Recursos

🚀 Busca Ultrarrápida: Utiliza a indexação instantânea de arquivos do Everything Search Engine
🔍 Consultas em Linguagem Natural: Busque usando descrições em linguagem natural, como "arquivos de vídeo grandes" ou "documentos recentes"
🎯 Opções de Busca Avançadas: Sensibilidade a maiúsculas/minúsculas, correspondência de palavras inteiras, suporte a regex
📁 Busca por Caminho: Busque em diretórios específicos ou em unidades inteiras
📊 Classificação Inteligente: Ordene por nome, caminho, tamanho ou data de modificação
🎨 Formatação Rica: Tamanhos de arquivo legíveis e datas formatadas
🌐 Instalação Global: Instale uma vez e use em todos os clientes MCP
⚡ Resultados em Tempo Real: Resultados instantâneos enquanto você digita
🔧 Altamente Configurável: Portas, escopos e parâmetros de busca personalizáveis

Início Rápido

Pré-requisitos

Windows OS (o Everything Search Engine é exclusivo para Windows)
Node.js 16+ - Baixe aqui
Everything Search Engine - Baixe aqui

Etapa 1: Instalar o Everything Search Engine

Baixe e instale o Everything Search Engine
Abra o Everything Search
Vá para Ferramentas > Opções > Servidor HTTP
✅ Ative o Servidor HTTP
Defina a porta para 8011 (padrão)
Clique em OK e reinicie o Everything

Etapa 2: Instalar o Servidor MCP

Opção A: Instalação Global (Recomendada)

npm install -g everything-search-mcp-server

Nota: Se você ainda não publicou no npm, os usuários devem usar a Opção B (a partir do código-fonte) até que o pacote esteja disponível no npm.

Opção B: A partir do Código-Fonte

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

Etapa 3: Configurar seu Cliente MCP

Para o Claude Desktop

Adicione ao seu claude_desktop_config.json:

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

Locais do Arquivo de Configuração:

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

Para o VS Code

Para instalação rápida, use um dos botões de instalação com um clique abaixo...

Para instalação manual, adicione o seguinte bloco JSON ao seu arquivo de Configurações do Usuário (JSON) no VS Code. Você pode fazer isso pressionando Ctrl + Shift + P e digitando Preferences: Open User Settings (JSON).

Opcionalmente, você pode adicioná-lo a um arquivo chamado .vscode/mcp.json no seu workspace. Isso permitirá que você compartilhe a configuração com outras pessoas.

Observe que a chave mcp é necessária ao usar o arquivo mcp.json.

Adicione ao seu settings.json do VS Code:

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

Locais do Arquivo de Configurações:

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

Nota: Certifique-se de que a extensão MCP esteja instalada no VS Code para suporte ao servidor MCP.

Etapa 4: Reiniciar seu Cliente MCP

Reinicie o Claude Desktop ou o VS Code para carregar o novo servidor.

Etapa 5: Verificar a Instalação

Teste se o 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

No seu cliente MCP, tente uma busca simples como:

"Buscar por arquivos README"
"Encontrar todos os arquivos .txt"
"Mostre-me arquivos de vídeo grandes"
"Encontrar documentos Word recentes"

Uso

O servidor fornece duas ferramentas poderosas:

1. `search` - Busca Avançada de Arquivos

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

2. `natural_search` - Busca em Linguagem Natural

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

Exemplos

Buscas Básicas

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

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

Buscas Avançadas

// 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
}

Buscas em Linguagem 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
}

Referência de Parâmetros

Parâmetros da Ferramenta `search`

Parâmetro	Tipo	Padrão	Descrição
`query`	string	obrigatório	String de consulta de busca
`scope`	string	`"C:"`	Escopo/diretório da busca
`caseSensitive`	boolean	`false`	Ativa correspondência com sensibilidade a maiúsculas/minúsculas
`wholeWord`	boolean	`false`	Corresponder apenas palavras inteiras
`regex`	boolean	`false`	Ativa expressões regulares
`path`	boolean	`false`	Buscar em caminhos de arquivo
`maxResults`	number	`100`	Máximo de resultados (1-1000)
`sortBy`	string	`"name"`	Ordenar por: `name`, `path`, `size`, `date_modified`
`ascending`	boolean	`true`	Direção da ordenação

Parâmetros da Ferramenta `natural_search`

Parâmetro	Tipo	Padrão	Descrição
`naturalQuery`	string	obrigatório	Descrição da busca em linguagem natural
`maxResults`	number	`100`	Máximo de resultados (1-1000)

Solução de Problemas

Problemas Comuns

Erro "Conexão recusada"
- Certifique-se de que o Everything Search esteja em execução
- Verifique se o Servidor HTTP está ativado (Ferramentas > Opções > Servidor HTTP)
- Verifique se a porta 8011 não está bloqueada pelo firewall
Erro "Comando não encontrado"
- Certifique-se de que o servidor esteja instalado globalmente: npm install -g everything-search-mcp-server
- Verifique se o Node.js está no seu PATH
Nenhum resultado retornado
- Permita que o Everything conclua a indexação inicial (pode levar alguns minutos para unidades grandes)
- Verifique se o Everything consegue encontrar arquivos pela interface gráfica primeiro
- Verifique se o escopo da busca existe e está acessível
- Certifique-se de ter permissões de leitura para o diretório de busca
Problemas de desempenho
- Reduza maxResults para respostas mais rápidas
- Use escopos de busca mais específicos para limitar a área de busca
- Considere usar extensões de arquivo exatas em vez de curingas

Configuração

Configuração de Porta Personalizada

Se você precisar usar uma porta diferente:

Altere a porta HTTP do Everything (Ferramentas > Opções > Servidor HTTP)
Defina a variável de ambiente: EVERYTHING_PORT=8012
Ou modifique o código-fonte do servidor

Modo de Depuração

Ative o registro de depuração:

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

Novidades

Versão 1.0.0 🎉

Lançamento Inicial: Implementação completa do servidor MCP
Busca em Linguagem Natural: Consultas de busca com tecnologia de IA
Instalação Global: Instalação fácil baseada em npm
Suporte a Múltiplos Clientes: Funciona com Claude Desktop, VS Code e outros clientes MCP
Opções de Busca Avançadas: Regex, sensibilidade a maiúsculas/minúsculas, busca por caminho
Documentação Completa: Guia abrangente de instalação e uso

Desenvolvimento

Compilação a partir do Código-Fonte

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

Executando Testes

npm test

Contribuição

Faça um fork do repositório
Crie um branch de funcionalidade: git checkout -b feature-name
Faça suas alterações
Adicione testes se aplicável
Faça o commit: git commit -am 'Add feature'
Envie: git push origin feature-name
Crie um Pull Request

Licença

Licença ISC - consulte o arquivo LICENSE para obter detalhes.

Suporte

🐛 Relatar Bugs: GitHub Issues
💬 Discussões: GitHub Discussions
📧 E-mail: anant.kamat.in@gmail.com

Projetos Relacionados

Everything Search Engine - O poderoso mecanismo de busca de arquivos com o qual este servidor se integra
Model Context Protocol - O protocolo que este servidor implementa
Claude Desktop - Assistente de IA com suporte a MCP

Feito com ❤️ para a comunidade MCP