Everything Search

Everything Search

An MCP server providing fast cross-platform file searching on Windows, macOS, and Linux.

270
Stars
36
Forks
2
Releases

Overview

Everything Search MCP Server provides fast, cross-platform file searching by delegating to platform-appropriate backends: the Everything SDK on Windows, the built-in mdfind/Spotlight index on macOS, and locate/plocate databases on Linux. It exposes a search tool that accepts a query and optional parameters including max_results (default 100, max 1000), match_path, match_case, match_whole_word, match_regex, and sort_by with a defined set of sorting options. The response for each match includes the file or folder path, file size in bytes, and last modified date. Prerequisites vary by platform (Everything SDK on Windows; locate/plocate on Linux; no extra steps on macOS). Installation and runtime options include Smithery installation, uv-based execution, or pip installation, with Windows configuration supported via the EVERYTHING_SDK_PATH environment variable. It can be used with Claude Desktop by adding appropriate claude_desktop_config.json entries. Debugging is supported via the MCP inspector, and logs can be viewed in standard Claude log locations. This MCP server focuses on providing reliable, fast cross-platform search capabilities suitable for integration with Claude/Desktop-like clients.

Details

Owner
mamertofabian
Language
Python
License
MIT License
Updated
2025-12-07

Features

Cross-platform file search

Provides fast file searching across Windows, macOS, and Linux using the appropriate backend for each platform.

Windows backend (Everything SDK)

Integrates with the Everything SDK to leverage Windows-specific indexing and search capabilities.

macOS backend (mdfind)

Uses macOS's built-in mdfind/Spotlight database for search on macOS.

Linux backend (locate/plocate)

Uses locate or plocate databases to perform searches on Linux.

Rich search parameters

Supports query, max_results, match_path, match_case, match_whole_word, match_regex, and sort_by for advanced queries.

Flexible sorting options

Offers multiple sort orders (by filename, path, size, extension, and date-based orders) via sort_by codes.

Standard response data

Each result includes the file/folder path, size in bytes, and last modified date.

Installation and runtime options

Multiple installation/run pathways: Smithery installation, uv-based execution, or pip installation; Windows requires the EVERYTHING_SDK_PATH when using the SDK.

Audience

DevelopersBuild and integrate cross-platform file search MCP servers for Claude Desktop or other MCP clients.
End users / power usersLeverage fast, system-wide search capabilities across Windows, macOS, and Linux via MCP integration.

Tags

Everything SDKmdfindlocateplocatesearchfile searchCross-platformWindowsmacOSLinuxMCP serverClaude DesktopSmithery