Log inSubmit server
MCP Everything Search logo

MCP Everything Search

by mamertofabian

Searches local files and folders through MCP using Everything, mdfind, or locate/plocate by operating system.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Everything Search

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mamertofabian-mcp-everything-search": {
      "command": "uvx",
      "args": [
        "mcp-server-everything-search"
      ],
      "env": {
        "EVERYTHING_SDK_PATH": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

mamertofabian/mcp-everything-search MCP server exposes local file and folder search through MCP. It uses the Everything SDK on Windows, Spotlight's mdfind on macOS, and locate or plocate on Linux. Search requests can limit results, match paths, apply case, whole-word, or regex rules, and select sorting. Use it when an agent needs to find files on the machine running the MCP server.

Use cases

  • Find source files by extension or filename
  • Locate folders on a local workstation
  • Filter indexed files by path or regular expression
  • Sort search results by size or modification date

Key features

  • Cross-platform local file and folder search
  • Everything SDK support on Windows
  • Spotlight mdfind support on macOS
  • locate or plocate support on Linux
  • Path, case, whole-word, and regex matching
  • Configurable result limits and sorting

Tools16

What MCP Everything Search lets your agent do. Expand a tool for its parameters.

Self-reported~250 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

19/19 checks healthy over the last 76d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · mcp-server-everything-search (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars367Stargazers on the source repository.
Last commit11d agoMost recent push to the default branch.
Tools exposed16Callable tools this server registers over MCP.
Directory activity9 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Everything Search works

What mamertofabian/mcp-everything-search MCP server does

mamertofabian/mcp-everything-search MCP server lets an MCP client search for files and folders on the host system. Results include each item's path, size in bytes, and last modified date. The implementation uses a platform-specific local search facility rather than a hosted search service.

Windows searches use the Everything SDK, macOS searches use the built-in Spotlight mdfind command, and Linux searches use the locate or plocate command. Search syntax therefore differs by operating system.

This fits workflows where an agent needs to locate source files, documents, folders, or other local paths. It does not describe file creation, modification, deletion, or content editing capabilities.

How it works

The MCP client sends a search request containing a required query and optional search controls. The server runs the corresponding local search backend and returns matching paths with metadata. By default, a request returns up to 100 results; the configured maximum can be raised to 1,000.

Available controls include matching against the full path instead of only the filename, case-sensitive matching, whole-word matching, regular-expression matching, and result ordering. Sort choices cover filename, path, size, extension, creation date, and modification date, with ascending and descending variants where documented.

On Windows, Everything must be installed and its service must be running. The SDK DLL must also be available to the server. Linux requires an initialized locate database. macOS needs no additional search utility setup because the server calls mdfind.

Setup and configuration

The documented package is mcp-server-everything-search. With uv, it can be run directly through uvx:

bash
uvx mcp-server-everything-search

The package can also be installed with pip and started as a Python module:

Terminal
pip install mcp-server-everything-search
python -m mcp_server_everything_search

Windows configuration requires EVERYTHING_SDK_PATH, set to the installed Everything SDK DLL, such as Everything64.dll. Linux users must install either locate or plocate and update its database with the appropriate system command.

The README provides Claude Desktop configurations using either uvx or the Python module. The Windows configuration passes EVERYTHING_SDK_PATH; the Linux and macOS examples do not define environment variables.

Tools and capabilities

The mamertofabian/mcp-everything-search MCP server provides a search operation with these inputs:

  • query: required search text.
  • max_results: result limit, defaulting to 100 and capped at 1,000.
  • match_path: search the complete path rather than just the filename.
  • match_case: enable case-sensitive matching.
  • match_whole_word: restrict matches to whole words.
  • match_regex: enable regular-expression matching.
  • sort_by: choose the documented filename, path, size, extension, creation-date, or modification-date order.

The repository's tool section calls the operation search, while the listing exposes query among the MCP tool fields. Platform-specific query syntax is documented separately in the project's search syntax guide.

Limitations and notes

Search behavior depends on the indexing or database service available on the host. Windows requires the external Everything application, its running service, and the SDK DLL. Linux results depend on the locate database being installed and current. macOS and Linux do not provide the same query feature coverage described for Everything on Windows.

The project is MIT-licensed and states that it is independent from, and not endorsed or sponsored by, voidtools, the creator of Everything.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Everything Search

Run `uvx mcp-server-everything-search`, or install `mcp-server-everything-search` with pip and run `python -m mcp_server_everything_search`.

Yes. The README includes Claude Desktop configurations using either `uvx` or the Python module.

Install Everything, ensure its service is running, download the Everything SDK, and set `EVERYTHING_SDK_PATH` to the SDK DLL.

Yes. macOS uses the built-in `mdfind` command. Linux uses `locate` or `plocate`, which must be installed and have an initialized database.

Related MCP servers

All in File Systems All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Everything Search AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mamertofabian-mcp-everything-search?style=directory)](https://allmcps.com/mcp/mamertofabian-mcp-everything-search)
HTML Embed
<a href="https://allmcps.com/mcp/mamertofabian-mcp-everything-search"><img src="https://allmcps.com/api/badge/mamertofabian-mcp-everything-search?style=directory" alt="MCP Everything Search on AllMCPs" /></a>