everything-search-server

MCP.Pizza Chef: Alihkhawaher

The everything-search-server is an MCP server that integrates with the Everything Search Engine, enabling advanced file search capabilities through the Model Context Protocol. It supports full-text search across files and directories with options for case sensitivity, whole word matching, regular expressions, and path-based searches. Users can sort results by name, path, size, or modification date, and view results with human-readable file sizes, formatted dates, and full file paths. This server requires Node.js 16+ and an enabled HTTP Server in Everything Search, typically running on port 8011. It empowers LLMs to access and query local file systems efficiently and flexibly.

Use This MCP server To

Perform full-text file searches across directories Enable case sensitive and whole word file searches Use regular expressions for advanced file querying Search files by path patterns Sort search results by name, size, or date Format search results with readable file sizes and dates Integrate local file search into AI workflows Provide LLMs access to local file system metadata

README

Everything Search MCP Server

An MCP server that provides integration with Everything Search Engine, allowing powerful file search capabilities through the Model Context Protocol.

Features

  • Full text search across files and directories
  • Advanced search options:
    • Case sensitive search
    • Whole word matching
    • Regular expressions
    • Path search
  • Sorting options:
    • By name
    • By path
    • By size
    • By date modified
  • Result formatting:
    • Human-readable file sizes
    • Formatted dates
    • Full file paths

Prerequisites

  • Node.js 16 or higher
  • Everything Search Engine with HTTP Server enabled

Everything Search Configuration

  1. Open Everything Search
  2. Go to Tools > Options > HTTP Server
  3. Enable HTTP Server
  4. Set the HTTP Server port to 8011 (this is the default port used by this MCP server)
  5. Click OK to save changes

Note: If you need to use a different port, you'll need to modify the port in src/server.ts where it connects to http://127.0.0.1:8011/

Installation

npm install
npm run build

Usage

The server provides a single tool through MCP:

use_mcp_tool:
- server_name: everything-search
- tool_name: search
- arguments:
  {
    "query": "search string",          // Required: Text to search for
    "scope": "C:",                     // Optional: Search scope (default: C:)
    "caseSensitive": false,            // Optional: Match case
    "wholeWord": false,                // Optional: Match whole words only
    "regex": false,                    // Optional: Use regular expressions
    "path": false,                     // Optional: Search in paths
    "maxResults": 100,                 // Optional: Max results (1-1000, default: 100)
    "sortBy": "name",                  // Optional: Sort by name/path/size/date_modified
    "ascending": true                  // Optional: Sort direction
  }

Example Searches

  1. Basic file search:
{
  "query": "*.txt",
  "maxResults": 5
}
  1. Advanced search with filters:
{
  "query": "test",
  "scope": "C:\\Users",
  "caseSensitive": true,
  "wholeWord": true,
  "maxResults": 10,
  "sortBy": "date_modified",
  "ascending": false
}
  1. Regex search in paths:
{
  "query": ".*\\.js$",
  "regex": true,
  "path": true,
  "maxResults": 5
}

License

ISC

everything-search-server FAQ

How do I enable the HTTP Server in Everything Search?
Open Everything Search, go to Tools > Options > HTTP Server, enable it, and set the port (default 8011).
What Node.js version is required to run everything-search-server?
Node.js version 16 or higher is required.
Can I change the default HTTP Server port?
Yes, modify the port in the src/server.ts file to match your Everything Search HTTP Server port.
Does everything-search-server support regular expression searches?
Yes, it supports regex for advanced file search queries.
How are search results formatted?
Results include human-readable file sizes, formatted dates, and full file paths for clarity.
Is everything-search-server compatible with multiple LLM providers?
Yes, it works with OpenAI, Anthropic Claude, and Google Gemini by providing structured file search context.
What platforms does everything-search-server support?
It supports any platform where Everything Search Engine and Node.js 16+ can run, typically Windows.
How does everything-search-server enhance AI workflows?
It allows LLMs to query local files efficiently, enabling context-aware responses and automation.