Everything Search MCP server

Everything Search MCP Server

<!-- mcp-name: io.github.mamertofabian/mcp-everything-search -->

An MCP server that provides fast file searching capabilities across Windows, macOS, and Linux. On Windows, it uses the Everything SDK. On macOS, it uses the built-in mdfind command. On Linux, it uses the locate/plocate command.

Requires Python 3.10+. Since 0.3.0 the server is built on the MCP Python SDK 2.x. See CHANGELOG.md for release notes.

Tools

search

Search for files and folders across your system. The search capabilities and syntax support vary by platform:

• Windows: Full Everything SDK features (see syntax guide below)
• macOS: Basic filename and content search using Spotlight database
• Linux: Basic filename search using locate database

Arguments are grouped into a base object (all platforms) and a platform-specific object. The server advertises only the current platform's object in its tool schema.

base (required):

• query (required): Search query string. See the syntax guide.
• max_results (optional): Maximum number of results to return (default: 100, range: 1-1000)

windows_params (optional, Windows only):

• match_path: Match against full path instead of filename only (default: false)
• match_case: Enable case-sensitive search (default: false)
• matchwholeword: Match whole words only (default: false)
• match_regex: Enable regex search (default: false)
• sort_by: Sort order for results (default: 1). Available options:

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

mac_params (optional, macOS only):

• search_directory: Limit the search to a directory (mdfind -onlyin). ~ is expanded; the directory must exist.
• literal_query: Treat the query as a literal Spotlight query string (-literal)
• interpret_query: Interpret the query as if typed in the Spotlight menu (-interpret)
• live_updates: Not supported. mdfind -live never exits, so setting it returns an error.

By default the query is a filename search (mdfind -name). Setting literalquery or interpretquery passes the query to Spotlight as-is instead; such a query must not start with -, because mdfind would read it as an option.

linux_params (optional, Linux only):

• ignore_case: Case-insensitive search, -i (default: true)
• regex_search: Treat the query as a regular expression (default: false)
• existing_files: Only list files that still exist, -e (default: true)
• count_only: Return only the number of matches, -c (default: false)

Examples:

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

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

{
  "base": {"query": "ENABLE", "max_results": 50},
  "mac_params": {"search_directory": "/Users/me/code/myrepo"}
}

Each result includes:

• Path: full path
• Filename: name, with the extension in parentheses when present
• Size: size in bytes
• Created, Modified, Accessed: timestamps, or N/A when unavailable

Shortened. The full README is on GitHub.