Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

essovius/mcp-everything-search

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

4 Commits

Repository files navigation

Everything MCP Server

PyPI version License: MIT

An MCP (Model Context Protocol) server that integrates Everything file search with Claude Desktop. Search your entire Windows filesystem instantly from Claude.

Features

  • ⚑ Instant search - Leverages Everything's lightning-fast file indexing
  • πŸ” Multiple search modes - Basic, filtered, regex, type-based, attribute-based
  • πŸ“ Folder operations - Search within specific paths, find empty folders
  • πŸ“Š Statistics - Get file counts and total sizes without listing files
  • πŸ• Recent files - Find recently modified files
  • πŸ“‹ Duplicate finder - Locate files with the same name
  • πŸ’Ύ Export - Save results to txt, csv, json, and more

Prerequisites

  1. Windows - Everything only runs on Windows
  2. Everything must be installed and running
  3. es.exe (Everything command-line) installed

Installation

Using uvx (recommended)

uvx mcp-everything-search

Using pip

pip install mcp-everything-search

Configuration

Add this to your Claude Desktop config file:

Location: %APPDATA%\Claude\claude_desktop_config.json

Using uvx

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

Using pip

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

Everything 1.5 Alpha Users

If you're using Everything 1.5 alpha, add the EVERYTHING_INSTANCE environment variable:

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

Then restart Claude Desktop.

Available Tools

Basic Search

Tool Description
search_files Basic file search with wildcards (*, ?), sorting options
search_with_filters Search with extension, size, path filters, files/folders only
search_regex Search using regular expressions

Specialized Search

Tool Description
search_by_type Search by category: audio, video, image, document, executable, compressed, code
search_folders Find only directories
search_recent_files Find recently modified files
search_duplicates Find files with the same name
search_by_attributes Filter by hidden, system, read-only, compressed, encrypted
search_empty_folders Find empty directories
search_large_files Find files over a specified size

Utilities

Tool Description
search_with_details Search with detailed output (size, dates)
get_result_count Get count of matches without listing (fast)
get_total_size Get total size of all matching files
open_file_location Open containing folder in Explorer
get_file_info Get file size, dates, and details
export_search_results Export to txt, csv, json, m3u, m3u8, tsv, efu

Example Queries

Ask Claude things like:

  • "Find all Python files in D:\Projects"
  • "Search for PDF files larger than 10mb"
  • "Find images modified in the last 3 days"
  • "Look for duplicate files named config.json"
  • "Find all video files in my Downloads folder"
  • "Search for files matching regex test_.*\.py$"
  • "Find empty folders in D:\Archive"
  • "What's the total size of all MP3 files?"
  • "How many JavaScript files are in this project?"
  • "Find hidden files in C:\Windows"
  • "Export all log files to a CSV"

Sort Options

Many tools support sort_by parameter:

  • name, path, size, extension
  • date-modified, date-created, date-accessed
  • Add -descending for reverse order (e.g., size-descending)

Development

# 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

License

MIT License - see LICENSE for details.

Acknowledgments

About

MCP server for Everything (voidtools) file search

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /