MCPs
Everything Search MCP Server

Everything Search MCP Server

Fast, cross-platform file search via Model Context Protocol integration.

View on GitHub

268

Stars

Forks

268

Watchers

Issues

Everything Search MCP Server provides fast file and folder search capabilities across Windows, macOS, and Linux platforms as an MCP server. It leverages native search utilities such as the Everything SDK on Windows, mdfind on macOS, and locate/plocate on Linux. The tool exposes a standardized search interface with customizable parameters including query, sorting, and matching options. It is suitable for integration with AI clients or automation tools that follow the Model Context Protocol.

Key Features

Fast file and folder search across Windows, macOS, and Linux

Supports advanced search filters and sorting options

Integrates with native search tools for each platform

Standardized MCP server interface

Customizable search parameters (query, sorting, matching)

Provides detailed results (path, size, last modified date)

Easy installation via Smithery, pip, or uv

Platform-specific optimizations for performance

No extra setup required for macOS

Detailed search syntax documentation

Use Cases

Automated system-wide file search for AI desktop assistants

Integrating advanced file search in productivity workflows

Contextual file retrieval for AI client applications

Power-user system search with customizable parameters

Supporting file lookup in automation scripts

Providing file meta-information for downstream applications

Instant access to recently modified or created files

Cross-platform desktop file management

Enabling search capabilities in chatbot or assistant tools

Bulk search and sorting for large file systems

README

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.

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

Parameters:

query (required): Search query string. See platform-specific notes below.
max_results (optional): Maximum number of results to return (default: 100, max: 1000)
match_path (optional): Match against full path instead of filename only (default: false)
match_case (optional): Enable case-sensitive search (default: false)
match_whole_word (optional): Match whole words only (default: false)
match_regex (optional): Enable regex search (default: false)
sort_by (optional): 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)

Examples:

json

{
  "query": "*.py",
  "max_results": 50,
  "sort_by": 6
}

json

{
  "query": "ext:py datemodified:today",
  "max_results": 10
}

Response includes:

File/folder path
File size in bytes
Last modified date

Search Syntax Guide

For detailed information about the search syntax supported on each platform (Windows, macOS, and Linux), please see SEARCH_SYNTAX.md.

Prerequisites

Windows

Everything search utility:
- Download and install from https://www.voidtools.com/
- Make sure the Everything service is running
Everything SDK:
- Download from https://www.voidtools.com/support/everything/sdk/
- Extract the SDK files to a location on your system

Linux

Install and initialize the locate or plocate command:
- Ubuntu/Debian: sudo apt-get install plocate or sudo apt-get install mlocate
- Fedora: sudo dnf install mlocate
After installation, update the database:
- For plocate: sudo updatedb
- For mlocate: sudo /etc/cron.daily/mlocate

macOS

No additional setup required. The server uses the built-in mdfind command.

Installation

Installing via Smithery

To install Everything Search for Claude Desktop automatically via Smithery:

bash

npx -y @smithery/cli install mcp-server-everything-search --client claude

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run mcp-server-everything-search.

Using PIP

Alternatively you can install mcp-server-everything-search via pip:

pip install mcp-server-everything-search

After installation, you can run it as a script using:

python -m mcp_server_everything_search

Configuration

Windows

The server requires the Everything SDK DLL to be available:

Environment variable:

EVERYTHING_SDK_PATH=path\to\Everything-SDK\dll\Everything64.dll

Linux and macOS

No additional configuration required.

Usage with Claude Desktop

Add one of these configurations to your claude_desktop_config.json based on your platform:

json

"mcpServers": {
  "everything-search": {
    "command": "uvx",
    "args": ["mcp-server-everything-search"],
    "env": {
      "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
    }
  }
}

json

"mcpServers": {
  "everything-search": {
    "command": "python",
    "args": ["-m", "mcp_server_everything_search"],
    "env": {
      "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
    }
  }
}

json

"mcpServers": {
  "everything-search": {
    "command": "uvx",
    "args": ["mcp-server-everything-search"]
  }
}

Or if using pip installation:

json

"mcpServers": {
  "everything-search": {
    "command": "python",
    "args": ["-m", "mcp_server_everything_search"]
  }
}

Debugging

You can use the MCP inspector to debug the server. For uvx installations:

npx @modelcontextprotocol/inspector uvx mcp-server-everything-search

Or if you've installed the package in a specific directory or are developing on it:

git clone https://github.com/mamertofabian/mcp-everything-search.git
cd mcp-everything-search/src/mcp_server_everything_search
npx @modelcontextprotocol/inspector uv run mcp-server-everything-search

To view server logs:

Linux/macOS:

bash

tail -f ~/.config/Claude/logs/mcp*.log

Windows (PowerShell):

powershell

Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -Wait

Development

If you are doing local development, there are two ways to test your changes:

Run the MCP inspector to test your changes. See Debugging for run instructions.
Test using the Claude desktop app. Add the following to your claude_desktop_config.json:

json

"everything-search": {
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/mcp-everything-search/src/mcp_server_everything_search",
    "run",
    "mcp-server-everything-search"
  ],
  "env": {
    "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
  }
}

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Disclaimer

This project is not affiliated with, endorsed by, or sponsored by voidtools (the creators of Everything search utility). This is an independent project that utilizes the publicly available Everything SDK.

Star History

Repository Owner

mamertofabian

User

Repository Details

Language Python

Default Branch main

Size 73 KB

Contributors 2

License MIT License

MCP Verified Nov 12, 2025

Programming Languages

Python

100%

Related MCPs

Discover similar Model Context Protocol servers

tavily-search MCP server

A search server that integrates Tavily API with Model Context Protocol tools.

tavily-search MCP server provides an MCP-compliant server to perform search queries using the Tavily API. It returns search results in text format, including AI responses, URLs, and result titles. The server is designed for easy integration with clients like Claude Desktop or Cursor and supports both local and Docker-based deployment. It facilitates AI workflows by offering search functionality as part of a standardized protocol interface.

⭐ 44
MCP
Tomatio13/mcp-server-tavily

OpenAI WebSearch MCP Server

Intelligent web search with OpenAI reasoning model support, fully MCP-compatible.

OpenAI WebSearch MCP Server provides advanced web search functionality integrated with OpenAI's latest reasoning models, such as gpt-5 and o3-series. It features full compatibility with the Model Context Protocol, enabling easy integration into AI assistants that require up-to-date information and contextual awareness. Built with flexible configuration options, smart reasoning effort controls, and support for location-based search customization. Suitable for environments such as Claude Desktop, Cursor, and automated research workflows.

⭐ 75
MCP
ConechoAI/openai-websearch-mcp

Code Declaration Lookup MCP Server

Fast, language-agnostic code declaration search and lookup server via MCP.

Provides a Model Context Protocol (MCP) server that indexes code declarations using universal ctags and SQLite with FTS5 full-text search. Offers search and listing functionality for functions, classes, structures, enums, and other code elements across any language supported by ctags. Enables seamless integration with coding agents for dynamic indexing, respects .gitignore, and supports ctags file ingestion and management.

⭐ 2
MCP
osinmv/function-lookup-mcp

Brave Search MCP Server

MCP-compliant server providing advanced Brave Search API tools via STDIO and HTTP.

Implements a Model Context Protocol (MCP) server for integrating with the Brave Search API, offering tools for web, local business, image, video, and news searches along with AI-powered summarization. Supports both STDIO and HTTP transports and adheres to established MCP conventions for context management. Provides structured tool schemas and customizable parameters to handle sophisticated search queries and results. Enables advanced filtering, multi-type result aggregation, and seamless integration for AI model workflows.

⭐ 337
MCP
brave/brave-search-mcp-server

RivalSearchMCP

Advanced MCP server for web research, discovery, and trend analysis.

RivalSearchMCP is an advanced Model Context Protocol (MCP) server designed to streamline web research, content discovery, and trend analysis. It offers tools for multi-engine web search, intelligent content retrieval, website analysis, and AI-driven content insights. The platform includes integrated trends analysis, research workflows with progress tracking, and automated generation of LLMs.txt documentation files. Its anti-detection features, real-time content streaming, and flexible data export options make it ideal for complex research and automation workflows.

⭐ 10
MCP
damionrashford/RivalSearchMCP

ArXiv MCP Server

Seamless AI access to arXiv papers via MCP interface

ArXiv MCP Server enables AI assistants to search, retrieve, and interact with research papers from arXiv using the Model Context Protocol. It provides programmatic access for paper search, download, reading, and management, supporting integration with MCP-compatible clients. The solution offers both installation via Smithery and manual setup, along with tools for efficient paper handling. Local storage ensures quick access to previously downloaded papers and relevant research prompts.

⭐ 1,863
MCP
blazickjp/arxiv-mcp-server

View all Alternatives

Didn't find tool you were looking for?

Search AI Tools

Everything Search MCP Server

Key Features

Use Cases

README

Everything Search MCP Server

Tools

search

Search Syntax Guide

Prerequisites

Windows

Linux

macOS

Installation

Installing via Smithery

Using uv (recommended)

Using PIP

Configuration

Windows

Linux and macOS

Usage with Claude Desktop

Debugging

Development

License

Disclaimer

Star History

Repository Owner

Repository Details

Programming Languages

Tags

Related MCPs