Everything Search

Implements a SearchProvider abstraction pattern that routes search requests to platform-specific implementations: Windows Everything SDK for indexed full-text search, macOS Spotlight via mdfind subprocess for metadata-aware search, and Linux locate/plocate for filename indexing. The MCP server normalizes heterogeneous result formats into a unified SearchResult data model, allowing clients like Claude Desktop to issue a single search query that adapts to the host OS without knowing platform details.

Wraps the Windows Everything SDK C library through Python bindings to execute full-text indexed searches with support for advanced query operators (wildcards, boolean operators, date/size filters, regex patterns). The WindowsSearchProvider translates normalized search parameters into Everything query syntax, executes queries via the SDK, and maps Everything result objects (with fields like path, size, modified_time, attributes) into the unified SearchResult format. Queries execute against Everything's real-time index, providing sub-millisecond latency on indexed content.

Implements MacSearchProvider that spawns mdfind (macOS Spotlight command-line interface) as a subprocess to execute metadata-aware searches. Translates normalized search parameters into mdfind query syntax, captures subprocess output, parses results, and normalizes them into SearchResult format. Supports Spotlight's metadata query capabilities (e.g., searching by file kind, creation date, author) in addition to filename/content search. Results reflect Spotlight's indexed metadata, providing fast search on macOS without requiring additional indexing infrastructure.

Implements LinuxSearchProvider that executes locate or plocate commands via subprocess to search a pre-built filename database. Translates normalized search parameters into locate/plocate syntax (glob patterns, regex), captures subprocess output, parses results, and normalizes into SearchResult format. The locate database is maintained by the updatedb command (typically run daily via cron) and provides extremely fast filename-only search without requiring real-time indexing. Falls back to plocate (faster variant) if available, otherwise uses locate.

Implements an MCP (Model Context Protocol) server that exposes the search tool through stdio-based bidirectional communication. The server handles MCP protocol framing, tool registration, parameter validation, and result serialization. Clients (like Claude Desktop) communicate with the server by sending JSON-RPC requests over stdin/stdout, and the server responds with tool results. The server detects the host platform at startup and initializes the appropriate SearchProvider backend, maintaining a single search tool interface across all platforms.

Implements a SearchResult data model that normalizes heterogeneous results from Windows Everything SDK, macOS mdfind, and Linux locate into a unified schema with fields: path (full filesystem path), name (filename only), size (bytes, null if unavailable), modified_time (ISO 8601 string, null if unavailable), is_directory (boolean), match_type (string: 'filename' or 'path'). Each platform provider maps its native result format to this schema before returning to the client. The schema includes validation to ensure all results conform to expected types and formats.

Implements parameter translation logic that converts normalized MCP search parameters (query string, max_results, match_case, match_whole_word, match_regex, sort_by) into platform-specific query syntax. Each SearchProvider subclass translates these parameters into the native query language: Windows Everything query syntax (operators, filters, regex), macOS mdfind syntax (metadata queries, glob patterns), or Linux locate/plocate syntax (glob patterns, regex). The translation layer handles incompatibilities (e.g., regex support varies by platform) and falls back to safe defaults when a parameter is unsupported on a given platform.

Implements platform detection logic that runs at MCP server startup to identify the host OS (Windows, macOS, or Linux) and instantiate the appropriate SearchProvider subclass (WindowsSearchProvider, MacSearchProvider, or LinuxSearchProvider). Uses Python's sys.platform or platform.system() to detect OS, then initializes the corresponding provider with any required configuration (e.g., Everything SDK path on Windows). The initialized provider is stored as a module-level singleton and reused for all subsequent search requests, avoiding repeated platform detection overhead.