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: 전체 Everything SDK 기능 (아래 구문 가이드 참조)
• macOS: Spotlight 데이터베이스를 이용한 기본 파일명 및 콘텐츠 검색
• 리눅스: 위치 데이터베이스를 이용한 기본 파일 이름 검색

인자는 base 객체(모든 플랫폼)와 플랫폼별 객체로 그룹화됩니다. 서버는 도구 스키마에서 현재 플랫폼의 객체만 광고합니다.

base (필수):

• query (필수): 쿼리 검색어. 문법 가이드를 참조하세요.
• max_results (선택): 최대 반환 결과 수 (기본값: 100, 범위: 1-1000)

windows_params (선택 사항, 윈도우 전용):

• 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.