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

Open Everything Search
Go to Tools > Options > HTTP Server
Enable HTTP Server
Set the HTTP Server port to 8011 (this is the default port used by this MCP server)
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

Basic file search:

{
  "query": "*.txt",
  "maxResults": 5
}

Advanced search with filters:

{
  "query": "test",
  "scope": "C:\\Users",
  "caseSensitive": true,
  "wholeWord": true,
  "maxResults": 10,
  "sortBy": "date_modified",
  "ascending": false
}

Regex search in paths:

{
  "query": ".*\\.js$",
  "regex": true,
  "path": true,
  "maxResults": 5
}

License

ISC