Windows、macOS、Linuxで高速なファイル検索機能を提供するMCPサーバーです。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:locate databaseを用いた基本的なファイル名検索

引数は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.