Everything Search MCP Server

🚀 Everything Search MCP Server

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

🚀 Quick Start

This server provides a seamless integration with the Everything search engine, offering a wide range of search features through the Model Context Protocol.

✨ Features

• Full-text search: Conduct cross-file and cross-directory full-text searches.
• Advanced search options:
  • Case-sensitive search.
  • Whole-word matching.
  • Regular expression search.
  • Path search.
• Sorting options:
  • Sort by name.
  • Sort by path.
  • Sort by file size.
  • Sort by modification date.
• Result formatting:
  • Human-readable file sizes.
  • Formatted dates.
  • Full file paths.

📦 Installation

Prerequisites

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

Everything Search Configuration

1. Open the Everything search application.
2. Navigate 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.

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

Installation Commands

npm install
npm run build

💻 Usage Examples

Basic Usage

The server offers a single tool for use via MCP:

use_mcp_tool:
- server_name: everything-search
- tool_name: search
- arguments:
  {
    "query": "Search string",          // Required: The text to search for.
    "scope": "C:",                     // Optional: Search scope (default: C:\).
    "caseSensitive": false,            // Optional: Case-sensitive search.
    "wholeWord": false,                // Optional: Whole-word matching.
    "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/date_modified.
    "ascending": true                  // Optional: Sorting direction.
  }

Advanced Usage

Example 1: Basic File Search

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

Example 2: Advanced Search with Filters

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

Example 3: Regular Expression Search in Paths

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

📄 License

ISC