MCP-сервер, обеспечивающий быстрый поиск файлов на Windows, macOS и Linux. В Windows он использует Everything SDK. На macOS он использует встроенную команду mdfind. В Linux он использует команду locate/plocate.

Требуется Python 3.10+. Начиная с версии 0.3.0, сервер построен на MCP Python SDK 2.x. См. CHANGELOG.md для примечаний к релизу.

Инструменты

поиск

Ищите файлы и папки по всей вашей системе. Возможности поиска и поддержка синтаксиса различаются в зависимости от платформы:

• Функции Windows: Full Everything SDK (см. руководство по синтаксису ниже)
• macOS: базовый поиск по именам файла и контенту с помощью базы данных Spotlight
• Linux: базовый поиск имён файлов с использованием базы данных поиска

Аргументы группируются в объект base (все платформы) и объект, специфичный для платформы. Сервер рекламирует только объект текущей платформы в своей схеме инструментов.

base (обязательно):

• query (обязательно): Строка поискового запроса. См. руководство по синтаксису.
• max_results (необязательно): Максимальное количество результатов (по умолчанию: 100, диапазон: 1-1000)

windows_params (опционально, только для Windows):

• match_path: Совпадение по полному пути вместо только имени файла (по умолчанию: false)

Everything Search MCP Server

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)
• match_whole_word: 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 literal_query or interpret_query passes the query to Spotlight as-is instead; such a query must not start with -, because mdfind would read it as an option.