Everything Search

🚀 Everything Search MCP Server

An MCP server that integrates with the Everything search engine, enabling powerful file search capabilities through the Model Context Protocol.

🚀 Quick Start

This MCP server integrates with the Everything search engine to provide comprehensive file search functionality. It offers various search options and result formatting features.

✨ Features

• Perform full-text searches in files and directories.
• Advanced search options:
  • Case-sensitive search
  • Whole word matching
  • Regular expressions
  • Path search
• Sorting options:
  • Sort by name
  • Sort by path
  • Sort by size
  • Sort by last modified date
• Result formatting:
  • Display file sizes in a human-readable format.
  • Format dates.
  • Show full file paths.

📦 Installation

Prerequisites

• Node.js 16 or higher
• Everything search engine with the HTTP server enabled

Everything Search Configuration

1. Open the Everything search.
2. Go to Tools > Options > HTTP Server.
3. Enable the 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 the changes.

⚠️ Important Note

If you need to use a different port, you must modify the port connecting to http://127.0.0.1:8011/ in src/server.ts.

Installation Commands

npm install
npm run build

💻 Usage Examples

Basic Usage

The server provides a 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: Case-sensitive matching
    "wholeWord": false,                // Optional: Match whole words only
    "regex": false,                    // Optional: Use regular expressions
    "path": false,                     // Optional: Search in paths
    "maxResults": 100,                 // Optional: Maximum number of results (1-1000, default: 100)
    "sortBy": "name",                  // Optional: Sort by name, path, size, or last modified date
    "ascending": true                  // Optional: Sorting direction
  }

Advanced Usage

1. Basic file search:

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

2. Advanced search with filtering conditions:

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

3. Search using regular expressions in paths:

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

📄 License

ISC